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Experience the Ultimate in Visual 
Programming... ProtoGen+ 


ProtoGen+ has unlimited 
interactive visual pro¬ 
gramming power. 

Create full-blown applications with 
toolbars, scrollable forms, screen 
navigation, data validation, and 
help messages, using a scaleable 
architecture for adding database 
access, report writing, and other 
application building components. 
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options for toolbars, menus, and 
other initial settings. Unlike 
AppWizard, which generates 
code that you have to compile to 
see run, ProtoGen+ displays the 
exact application options you 
have selected within its design 
window. Unlike the wizards, you 
can point and click to link 
screens to menus and toolbars. 

Enjoy new levels of 
ease and productivity 
with ProtoGen+'s pro¬ 
totyping capabilities. 

In addition, as you design your 
screens you can define data vali¬ 
dation, colors, fonts, help and 
error messages, which all display 
live in ProtoGen+’s test mode. 



fThe ProtoGen+ workbench displays your application 
as you design it, giving you fast access to your applica¬ 
tion code and resources. 

What the experts are saying about ProtoGen+: 


♦ Visually link dialogs, code, programs, 
MDI Windows, and other components 
to menu items and toolbar buttons. 

Quickly go from user specification 
to product demonstration. 
Eliminate weeks and months from 
your development schedule. 

With ProtoGen+ you don't have to 
wait for a compile to see your 
applications run. With a click of 
the mouse you’ll be live in test 
mode. Like AppWizard, you start 
your application by selecting 


ProtoGen+ comes with C, OWL 
MFC and Pascal generators 

ProtoGen+ NT is the 
fastest way to create 
32-bit applications. 

ProtoGen+ NT has all the 32-bit 
power you need with hosted 
16/32-bit application develop¬ 
ment for the MIPS, DEC Alpha, 
and Intel processors. 

ProtoGen+ Only $199 
ProtoGen+ NT Only $495 



y “ProtoGen+ successfully brings to Windows 
programmers 4GL ease of use and 3GL perfor¬ 
mance”. -Ron Carnahan, DBMS 


ProtoGen+ Client/Server Suite 


y “ProtoGen+ is a natural winner. Every 
developer who sees the ProtoView tools seems 
to relish the ease of both modifying and testing a 
user interface under construction. ” 

-Peter Coffee, PCWeek 

y “ProtoGen+ will pay back your investment with 
much faster and easier prototyping and program 
development." -Neil J. Rubenking, PC Magazine 

y “On a scale of 1 to 10, I’d rank ProtoView as a 
10 (the best).” 

-Richard Hale Shaw, Windows Tech 


The ProtoGen+ Client/Server Suite 
harnesses the power and speed of C 
and C++, the world's fastest lan¬ 
guages. The ProtoGen+ Client/Server 
Suite delivers an integrated compo¬ 
nent toolset in an open architecture 
that includes database access, forms 
building, report writing, application 
management and quality code gener¬ 
ation in C, MFC, OWL, and Pascal. 

Here's what's included in the 
ProtoGen+ Client/Server Suite. 

y ^ProtoGen+ - A visual development 
workbench that includes everything 
needed to visually develop screens, 
create menus, link screens and 
dialogs, test the app, and generate 
source code. 

^WinControl Library - A rich set of 
custom controls that let you obtain, 
format and edit data entered by 
users. 


■^SQLView - Fast, easy visual data¬ 
base access through ODBC and 
Q+E database drivers. All the Q+E 
drivers are included FREE! SQLView 
also supplies a database-indepen- 
dent API for low-level control of data 
access and manipulation. Support is 
provided for all major PC and SQL 
databases. 

^DataTable and Lens Object - 

This control helps automate data¬ 
base browsing and updating. 

^Crystal Report Writer Pro with 
Report Writer Visual Coder - 

Visually create great looking reports. 
The Visual Coder acts as an integrat¬ 
ed component in ProtoGen+ generat¬ 
ing code for the report, creating links 
to the report, and executing the 
report in our live test mode. 
ProtoGen+ Client/Server Suite 
Only $995 



fThe ProtoGen+ Client/Server Suite provides 
direct access to all major PC and SQL databases. 

Call to order now. 

1 - 800 - 231-8588 


Fax: (908) 329-8624 Tel: (908) 329-8588 
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No matter what database they throw at you, you’ll 
connect with 1NTERSOLV ODBC Pack. 



Fastball, slider, or change-up. 
dBASE, Paradox, or Oracle. If you 
want to connect, you know 
you’ve got to react fast. 

With the comprehensive 
lineup of over 20 drivers in 
INTERSOLV ODBC Pack, you can. 

Cover all your bases with 

INTERSOLV. 

Drivers are the critical link 
between your ODBC-compliant 
applications, your network, and your 
databases. And because their quality 
directly affects the performance of 
your applications, it’s vital that you 
nave superior drivers. 

Don’t risk costly errors. Rely on 
INTERSOLV for fast, dependable 
drivers. 

INTERSOLV ODBC Pack 
delivers: 

• Comprehensive coverage: Connect 
all ODBC-compliant applications to 
all major SQL and PC DBMS with 
INTERSOLV ODBC Pack. 

• Consistent access: INTERSOLV 
ODBC Pack drivers make all data¬ 
bases look the same so you don’t 
have to change the way you work 
every time you change databases. 

• State-of-the-art technology: 

INTERSOLV ODBC Pack gives you 
the same database access technology 
used by leading software publishers. 

Plus all drivers are certified through 
INTERSOLV’s ODBC Verification 
Suite. 

• High-level implementation: With 
INTERSOLV ODBC Pack you get 
full SQL, transaction processing, 
and even network locking support 
for non-SQL DBMS. And it’s the 

INTERSOLV ODBC Pack provides support for the 
following databases: 

ALLBASE, Btrieve, Clipper, DB2, DB2/2, DB2/6000, dBASE, Excel, FoxBase, FoxPro, Gupta 
SQLBase, IMAGE/SQL, INFORMIX, INGRES, Microsoft SQL Server, Netware SQL, Oracle, 
Paradox, PROGRESS, SQL/400, SQL/DS, Sybase SQL Server, Sybase System 10, Teradata, 
Text, and XDB. 

INTERSOLV ODBC Pack is available for Windows OS/2, Windows NT, and Solaris and 
will support Macintosh in late 1994. Not all DBMS are available on all platforms and 
some may require a gateway. Please call for details 


only set of drivers that 
sports a consistent level of ODBC 
Core, Level 1, and selected Level 2 
functions. 

• One-stop, cross'platform support: 
No other set of ODBC drivers offers 
the range of support available from 
INTERSOLV. Support is available 
for Windows OS/2, Windows NT, 
and Solaris; support for Macintosh 
will be available in late 1994. 

Complete, dependable, and 
quick, INTERSOLV ODBC Pack 
makes sure your applications 
perform — no matter 
what database you 
have to face. 


Order INTERSOLV 
ODBC Pack today! 

Make sure your ODBC com¬ 
pliant applications work tomorrow. 
Put INTERSOLV ODBC Pack on 
your team today! Purchase directly 
from INTERSOLV. At only $499 . 
it’s a steal! 

Get a free ODBC booklet! 

Be sure to request your FREE 
copy of Getting Connected — 

An ODBC Primer, whether 
you order INTERSOLV 
ODBC Pack or not. Call: 

1-800-876-3101 

ext. D019, 8 am to 8 pm EST. 


.f 

INTERSOLV 


©INTERSOLV, Inc. All rights reserved. INTERSOLV, Excelerator, Maintenance Workbench, PVCS, AND Q+E are registered trademarks 5540 Centerview Drive, Suite 324 • Raleigh, NC 27606 
and APS is a trademark of INTERSOLV, Inc. Other company or product names mentioned herein may be trademarks or registered 800-876-3101, (919) 859-2220, Fax (919) 859-9334 

trademarks of their respective companies. 
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MFC Programming_ 

Making MFC Support Dynamic Extension Libraries. 5 

Microsoft’s Foundation Class (MFC) library lets you extend it with your own DLLs. Unfortunately, if your 
extension DLLs are loaded and unloaded dynamically at runtime, MFC will keep accessing the invalid 
module handle of the unloaded DLL. Here’s how to work around this problem. 

Greg Johnson 

Mixing DDE and VBX Controls in MFC Programs. 11 

MFC does not offer DDE support, but you can call DDE functions directly by including ddeml.h. 
Unfortunately, if you are also using VBX support (afxext.h), you get a redefinition error. Paul shows 
how to solve the problem with a little editing of header files. 

Paul Scholz 

OLE 2 Automation with Visual C++. . 15 

OLE 2.x is a huge, complicated API. Fortunately, Microsoft's Foundation Class (MFC) library offers a 
simpler way to implement OLE 2.x in your application. This article shows how to create an OLE automation 
server with Visual C++ vl.5. 

Louis and Karen Ross 

Features 


More Undocumented WinHelp Macros. 33 

Jim’s previous article revealed the meaning of most of the undocumented macros known to exist in 
WinHelp. This article wraps up the few remaining mysteries. 

Jim Mischel 

Windows NT File System Developers Conference Report .... 39 

At a small conference in Seattle, Microsoft began revealing the information needed to write custom 
file systems for Windows NT. Here’s a look at what went on. 

Paula Tomlinson 

Columns 


Tech Tips. 43 

Scooper N. Ong displays his code for centering dialogs. Jean-Francois Larvoire provides an explanation 
of Windows’ anti-social treatment of multi-partition disks. Mark Szamrej and Steve Valliere write in about 
a previous MessageBoxf) tip. 

Leor Zolman 

Books in Brief. . 59 

Byte’s Windows Programmer's Cookbook, by L. John Ribar; Byte’s DOS Programmer's Cookbook, by Craig 
Menefee, Lenny Bailes, and Nick Anis; Byte’s OS/2 Programmer’s Cookbook, by Kathy Ivens and Bruce 
Hallberg; Managing Software Maniacs, by Ken Whitaker; Inside the Windows NT File System, by Helen 
Custer. Plus, the best books of 1994! 

Ron Burk 

Windows Questions and Answers. 65 

This month’s column is devoted to feedback and corrections from readers. Steve Alpert points out a bug in 
Paul’s code to create hidden VMs. Larry Kuenning points out that the Windows 3.0 sound functions are still 
there in 3.1, sort of. Jerry Kelley corrects errors related to a past waveform audio question. Roger Samaan 
proposes a simpler method for accessing huge data with far pointers. 

Paul Bonneau 

Bug++ of the Month. 79 

If you turn on Visual C++ optimization, allocating an array of objects can produce code that seems to work, 
but in fact is wasting time and space allocating and initializing hundreds more objects than you requested! 
Mark Nelson 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 




Discover the secrets the insiders use 
with Windows Source! 


Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

❖ Identifies all imported function 
calls, including Windows API calls. 

❖ Labels all exports from an execu¬ 
table, DLL or device driver. 

❖ Includes Codeview symbols when 
available. 

❖ Identifies, by name, the VxD API 
entry points and services provided. 

❖ Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $249.95! 

Call 800-648-8266 
to order now! 

_ V Communications, Inc. 

\\ V4320 Stevens Creek Blvd., Suite 275-WD 
V- San Jose, CA 951 29 FAX 408-296-4441 
408-296-4224 


From the Editor 


The October issue mentioned that you can get Microsoft's new graphics 
library, WinG, from CompuServe. Several readers have asked if it is available 
on the Internet. Try ftp.microsoft.com:/developer/DRG/HinG/gamesum.zip (thanks to 
Sam Henderson and Steve Banfield of Microsoft for that info). Also, the beta 
version of WinG (just4u.zip) in the WINMM forum of CompuServe has been 
replaced with WinG 1.0, in a file named wingfl.zip. ♦♦ Don't forget that 
you can use email instead of mailing in a reader service card to get more 
information on products. Just email the reader service number and current 
issue number (05.12) to wdrs@rdpub.com. Memory prices don't seem 

to budge, but hard disk prices are getting too good to resist. For example, 
Corporate Systems Center (408-734-3475) has 1Gb IDE drives for $495 (they 
may be cheaper by the time you read this)! Specifically, those are Micropolis 
2112A 3.5" internal drives, with about a 10ms access time, one-year warranty, 
but no controller. ♦♦ I know a lot about hard disk prices because I lost a 
second one this month. That's why there's no Practical C++ column in this 
issue, but it should be back next month. ♦♦ Does anyone have a good re¬ 
placement for Microsoft's utility for displaying debugging output in a window, 
DBWIN? DBWIN's window can only hold a small amount of text, and it also 
seems to slow my system to a crawl, probably because its DLL is posting more 
messages than DBWIN's input queue can hold. Periscope's WinScope does a 
much better job, handling more than 64Kb of data, either in a circular queue 
or paging to disk, but it's like using a cannon to kill a gnat - a small, dedi¬ 
cated utility would be nice. ♦♦ I was debugging a convoluted batch file, 
having to type in 100+ character command lines by hand to figure out what 
option was going wrong. Suddenly, I realized that I never have to retype any¬ 
thing that scrolls across my DOS screen because I use FrontRunner, Phar Lap's 
replacement for Program Manager. I can select any text (even if it already 
scrolled off) with the mouse, and click with the secondary button to stuff those 
characters into any DOS program. I sure hope Chicago has this feature, or that 
Phar Lap makes a Chicago version of their product. ♦♦ Speaking of Chicago, 
have you noticed that no one says "Win32c" anymore? It's as though we all 
want to believe that there's just one 32-bit API now. Unfortunately for anyone 
writing complex applications, the differences between the Chicago API and the 
Windows NT API can be significant, depending on what you're doing. ♦♦ I 
must have exceeded my brain's limits for caffeine when I was editing Dave 
Boll's article on 24-bit ROPs in the October issue. 1 inserted a paragraph that 
implied that George Boole was alive and kicking in the 1950s, only off by a 
hundred years or so. Oh well, at least I didn't claim Mr. Boole was currently 
teaching EE 530 at Kansas University. My apologies to Dave, and thanks to 
Benjamin L. Combee for pointing out my error. 



Ron Burk 

Editor 

CIS: 70302,2566; Internet: ronb@rdpub.com (“...iuunetirdpubironb") 
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MFC Programming 



Making MFC Support 
Dynamic Extension Libraries 

Greg Johnson 

The latest versions of the Microsoft Foundation Class Library provide better 
DLL support than MFC vl.O. In addition to being able to build MFC as a DLL 
(like mfc250.dll), you can also place your own MFC-derived C++ classes in a 
DLL, which Microsoft refers to as an 'MFC extension DLL.' These DLLs are de¬ 
scribed in technical note 33 in mfcnotes.hlp, one of the help files that comes 
with Visual C++ vl .5. As with any DLL, you might load an extension DLL im¬ 
plicitly (by linking your application with an import library), but you might also 
decide to load it dynamically at runtime, by calling LoadLibraryO to load the 
DLL and then calling FreeLibraryO when you no longer need the routines in 
that DLL. Dynamic DLL access not only lets you unload the DLL when it is not 
needed, but also gives you control over error situations, such as a missing DLL, 
or an incorrect version of a DLL. Unfortunately, MFC does not quite correctly 
handle dynamically loaded extension DLLs. This article shows how to remedy 
that situation. 

The Problem 

The technical note mentioned earlier tells you to create an instance of CDyn- 
LinkLibrary when creating an MFC extension DLL. And what does this mysteri¬ 
ous CDynLinkLibrary class do? It puts your DLL on a list that helps MFC make 
the DLL's resources implicitly available to your application. For example, if the 
application calls CString: :LoadString(ID_STRING_I_klANT), the LoadStringO method 
searches the list of CDynLinkLibrary pointers to retrieve the instance handle of 
the each DLL, searching each for the desired resource. This relieves you of the 
need to write code for setting and maintaining the DLL instances using the 
AfxGetResourceHandleO and AfxSetResourceHandle(HINSTANCE) calls. Unfortunately, 
although this implicit resource sharing works for strings and dialog templates, it 
does not hold true for CBitmap: :LoadBitmap(). 

The problem with CDynLinkLibrary is that when an extension DLL has been 
dynamically loaded with the LoadLibraryO function, initialized, used, de-initial- 
ized, and then freed by a call to FreeLibraryO, there will be application errors 
(such as 'Invalid Global Handle') for the DLL instance handles that no longer 
exist (because they were unloaded explicitly). Fortunately, Windows handles 
this error gracefully, figuring that the programmer is simply overdosing on 
Mountain Dew and ignoring requests for nonexistent modules. It seems that 
the developers of MFC forgot to remove the CDynLinkLibrary from the list when 
it is destroyed. 


Greg Johnson is a principal software engineer with Digital Equipment Corporation. He 
has 18 years experience in applications/systems development, 6 years experience with 
corporate applications development in Windows 2.x, 3.x, and NT, and 5.5 years in 
C++/Windows client workstation/database development. You may contact him via In¬ 
ternet as gregj@world.std.com or via CompuServe at 76300,350. 
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The Solution with Visual C++. All that is needed to clean up the CDyn- 

One of the nice things about MFC is that solutions are LinkLibrary list is to derive a class from CDynLinkLibrary 

relatively simple, since the source code for MFC is included and do the cleanup in the destructor of the derived class. 


Figure 1 Basis improved MFC extension DLL code 

#1fdef DEBUG 
#undef THIS FILE 

Static Char BASED CODE THIS FILED * FILE ; 
fendlf 

finclude "afxdI1x.lt" 
finclude "dynllnk.h" 

Static AFX EXTENSION MODULE NEAR extenslonDLL 
* { NULL, NULL }; 

HINSTANCE hL1bInstance= NULL; 

CHyDynLinkLIbrary* pMy0ynL1nkL1b= NULL; 

#1 fdef_cplusplus 

extern "C" { 
fendlf 

Int CALLBACK LIbHalnIHINSTANCE hlnstance.UINT nDataSeg. 

UINT heapslze.char* szCtndLlne) 

{ 

hL1bInstance= hlnstance; 

AfxInltExtenslonModuIelextensionDLL. hlnstance); 
return 1; 

) 

Int FAR PASCAL WEPdnt exltparm) 

{ 

return(exltpam); 

) 

void DLLAPI InltFdCtrlDLL(vold) 

{ 

If(lpHyDynLlnkLib) 

pMyDynL1nkLib= new CMyDynLInkLIbrary(extenslonDLL ) ; 

return; 

} 

void DLLAPI ExltDLL(vold) 

{ 

1f(GetModul eUsageChLIhlnstance) <= 1) 

( 

delete pMyDynLInkLIb: 
pMyDynL1nkL1b= NULL; 

} 

} 

HINSTANCE DLLAPI GetMyLlbHandle(void) 

{ 

return(hLlblnstance); 

) 

#1fdef_cplusplus 

} // extern "C" 

fendlf 

/* End of File */ 


Developer's Toolkit 


Fastest, Most Powerful Text 
Retrieval Technology Available 

Based on ZylNDEX—leader from the beginning 
in PC text retrieval 



• Search 1 GB in Less Than 5 Seconds 

• Up to 50 Million Documents, 10 GB Total Per Index 

• Powerful Searches: Word, Phrase, Proximity, Boolean, 

Wild Cards and More 

• Works Directly with MS Word, WordPerfect, AmiPro, 

dBASE, ASCII, and Others 

Ideal for use with high-level application development 
environments such as Visual Basic, ToolBook, 
KnowledgePro, and ObjectVision. 


Windows, DOS, and NT 
libraries available $3,995 
Call for Specs and Demo. 

100 Lexington Drive • Buffalo Grove, IL 60089 
Phone: (708) 459-8000 • Fax (708) 459-8054 
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TUB Version Control 

For DOS, OS/2 and Windows-NT 

• The experts loved TLIB 4: 

"...amazingly fast... TLIB is a great system." PC Tech Journal 
"TUB has features and power to spare... TLIB is easy to use and 
the fastest of the reviewed packages." Computer Language 
‘7 will not program without it." Uptime Magazine 

. TLIB 5.01 adds: 

Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 
And now... automated conversion from PVCS'“ or MKS RCS! 

• Plus the features they loved in TLIB 4: 

Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon NLs in the file like other 
products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats, integrated with industry-leading MAKE 
from Opus™ software. 

MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 

5-user net: DOS $419, OS/2+NT+DOS $595. Call for other sizes. 


Burton Systems Software 



PO Box 4157, Cary, NC 27519 (919) 233-8128 

FAX: 233-0716 
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LAUNCH BAR 

FrontRunner’s Launch Bar offers 
one-button launching of your favorite 
applications. Customize it any way 
you like! 


COPY & PASTE 

Just highlight and click to copy and 
paste any part of your DOS session into 
a Windows or DOS program. 

COMMAND LINE POWER 

Run DOS or Windows programs right 
from the DOS prompt! 

• 

POWERFUL REAL TIME 
STATUS BAR 

FrontRunner’s Status Bar displays 
real-time information including 
system resources... and lets you 
write modules to display your own 
up-to-date information! . 


Bringing the best of DOS to 
Windows... And the Power 
of Windows to DOS 

Frustrated with switching between 
Windows and DOS applications? Now 
you can get the command-line power 
you need — integrated with the 
Windows graphical features you want. 
Phar Lap FrontRunner is a powerful 
DOS-based Windows desktop that 
brings intuitive GUI features to 
command-line DOS. FrontRunner lets 
you run Windows programs directly 
from the DOS prompt, provides an easy- 
to-use, menu-driven alternative to 
Program Manager, lets you launch 
applications with a click, keeps custom 
information at hand with Phar Lap’s 
unique Status Bar, and much more! 


SIMPLIFIED RUN MENU 

Run Menu offers Program Manager functionality 
without navigating through all those open windows! 


HISTORY 

Scroll to view the complete 
history of your DOS session. 


. 

FffffitEUyiner- [Command Shell Window#! (Suspended)] 


, File Ed it Settings TasIc^^Run Window Help 

V * 


SBPRO 

AUTOEXEC 001 
SCANCODE 
AUTOEXEC 002 
AUTOEXEC 003 
AUTOEXEC B~K 
DATA TXT 

DB EXE 

0PT2_fWS 


IUIIY 
fflrfEDEMO 
WW60DEM0 
WPPDEMO 
PUB0EM0 
PUB0EM02 
W0RX0EM0 
AUTOEXEC BAT 
ADEDEM0 
INTERACT 


<DIR> 

541 

3328 

541 

541 

535 

188 

2179334 

<DIR> 


<U1K> 

<DIR> 

<DIR> 

<DIR> 

<DIR> 

<DIR> 

<0IR> 


12-16-93 
09-01-93 
11 09-93 

11- 05-93 
11 08-93 

12- 09-93 
08-19-92 
09-09-92 
12-07-93 





FRONTRUNNER OFFERS YOU: 

A Better DOS Box — Scroll and 
view your entire DOS screen 
history and run Windows programs 
directly from the DOS prompt 
Quick and Easy Program Manager 
Replacement — no more searching 
through all those windows 
Customizable Launch Bar — instant 
access to your favorite programs 

✓ Powerful Visual Batch Language 
Extensions for DOS — easily 
create visual front ends 

✓ Programmable Status Bar — view 
the real-time information you need 
most 

✓ Versatile Utilities — to enhance 
your productivity 


Now you can test ride a winner with our 
free FrontRunner Lite and Guided Tour 
Demo disks. FrontRunner Lite is a trial¬ 
sized version of our DOS desktop for 
Windows that lets you try all of 
FrontRunner’s powerful features... 
absolutely free! So call today and see 
how exciting a winning DOS desktop 
can be! 


Phar Lap Software, Inc. 

60 Aberdeen Avenue, Cambridge, MA 02138 617-661-1510 FAX: 617-876-2972 

Phar Lap® and FrontRunner® are registered trademarks of Phar Lap Software. Inc. All other product names and company names are trademarks or registered trademarks of their respective holders. 
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Figure 2 Declaration for derived library class 


#ifndef DLLAPI 

fdefine DLLAPI FAR PASCAL _export 
lendIf 

class CMyDynLInkLIbrary : public CDynLInkLibrary 
{ 

public: 

DLLAPI CMyDynLInkL1brary(AFX_EXTENSI0N_M0DULE4 state); 
virtual DLLAPI ~CMyDynL1nkL1brary(vo1d); 

}; 

/* End of File */ 


Help Magician Pro 3.0 

The Professional Help Authoring 
Tool That Everyone Can Use! 

Beginners Love It 
Because It’s So Easy. 


With Help Magician Pro 3.0, 
you can develop online help and 
documents seamlessly in a true 
WYSIWYG environment much 
like WinHelp. If you have 
manuals or documents, Help 
Magician Pro will import them 
from any popular Windows 
word processor and convert 
them to online help. You can 
simultaneously test your help 
files while working on them. 


Experts Love It 
Because It’s So Powerful. 

Help Magician Pro has all the 
flexibility you’ve come to expect 
from a professional help 
authoring tool like support for 
ALL WinHelp 3.1 features,' a 
fool-proof macro editor, 
multi-file project management, 
multimedia support, automatic 
glossary creation, and much 
more. 



This does mean that before calling FreeLibraryO you must 
call the ExitDLLO function. Figure 1 shows the LibMainO, 
UEPO, InitDllO, and ExitDLLO routines that are described 
in the MFC Tech Notes with the additional variables for 
maintaining the CDynLinkLibrary derived class instance, i 
derive a class from CDynLinkLibrary called CMyDynLinkLibrary 
to correct the cleanup problem. The pointer to the CMyDyn¬ 
LinkLibrary instance is maintained as a global variable in 
the DLL's local data segment. Because the memory man¬ 
ager does not allow you to allocate or deallocate memory 
in the LibMainO or UEPO functions when using the exten¬ 
sion DLLs, I call InitDLLO after the 
DLL is loaded, and call ExitDLLO just 
before the DLL is freed. On exiting, I 
check the reference count, since just 
deleting the CDynLinkLibrary object 
may cause some other applica¬ 
tion/DLL to fail. 

Figure 2 shows the CMyDynLinkLi¬ 
brary derived class declaration. It is 
simply a constructor and destructor. 
The destructor handles the cleanup 
when the DLL is no longer needed. 
Figure 3 contains the implementation 
of the constructor and destructor. As 
you can see, the destructor simply 
examines the first pointer in the 
linked list of CDynLinkLibrary objects 
to see if it refers to the this pointer 


Actual Editing Environment 

Here’s The Scoop. 

The Help Magician is a proven 
product with years of customer 
support and satisfaction. We can 
demonstrate that the Help 
Magician Pro has more features 
and is faster and easier to use 
than any other help authoring 
tool. Drop us a line at 
1-800-542-2742 to get more 
details and a FREE fully 
functional demo disk. The Help 
Magician Pro now includes the 
Help Compiler and SHED editor. 


Order your copy of the Help Magician Pro 3.0 today. Only $249! 
30-day satisfaction money-back guarantee. 

Corporate site and network licensing available. 


| , t . ’ says "Designing help 
i i L systems is so easy that 
H you might even want to 


use it as a hypertext 
authoring tool. Certainly for 
Windows programmers it’s 
indispensable." 


dll Software 
“t> Interphase 
•V11 Incorporated 

82 Cucumber Hill Rd, #213 
Foster, Rl 02825 
Voice: (401)397-2340 
Fax: (401)397-6814 


; J 


Notice 

To Our Subscribers 


Occasionally, 

Windows/DOS Developer’s 
Journal makes its mailing 
list available to vendors of 
products we think our 
readers will find interesting. 
Current subscribers receive 
free information in the mail 


If you prefer that your name 
not be used in these 
mailings, please let us 
know. Just copy or clip this 
form and send it with your 
name and address to: 


Windows/POS 

□ DEVELOPER'S JOURNAL 

Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 USA 
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When protecting your software against piracy and 
unauthorized use, make sure that your protection 
system has all the following qualities: 


A GOOD HARDWARE KEY 



Hardware-based software protection systems are now the 
standard worldwide. However, not all keys are the 
same. A good key should have all the following 
features: 

l/ Compatibility and transparency. The key 
should work without any problem on your 
customers’ computers. The user should be 
able to forget the key after connecting it. 

l/ Unbreakable electronics. A customized ASIC 
(Application Specific Integrated Circuit) component 
integrated into the key to prevent reverse engineering 
and make cracking the hardware virtually impossible. 


A unique and inaccessible developer’s code burnt into the ASIC. This 


code should never be held in the key’s memory, where it can be read and 
altered. 

t/ A Read/Write Memory inside the key should be 
available. The memory should be writable in the 
field, on any PC, without any special programming 
equipment. 

l/ Very low power consumption, enabling the 
key to work even under the most adverse power 
conditions, on PCs and laptops, with or with¬ 
out a printer. 

POWERFUL SOFTWARE 

\/ A Linkable Protection Module with which calls can be made to 
the key from any point in the protected program. 

)/ An “Envelope” protection utility. Such programs enhance security while 
making it possible to protect a software application even without its source 
code. 

^ Sophisticated antidebugging and encryption mechanisms. 




HASP'- The Professional Software 
Protection System 1 


MacHASP - The Professional Software Protection System for the Macintosh 


HASP® OFFERS YOU 
ALL THESE FEATURES 
AND MORE: 

HASP was designed by a team of computer ex¬ 
perts, professional cryptologists, and electrical 
engineers. As a result, HASP keys are supported 
by what is probably the best software in the mar¬ 
ket, and the HASP system has worked on every 
computer it has been tried on. In addition to all 
the features mentioned above, HASP provides: 

\/ A Full Authorization System for protecting 
dozens of programs using only one key. 

)/ A Pattern Code Security System (PCS) which 
enables parallel processing of multiple calls by 
the Linkable Protection Module. 

l/ A Virus Detection option that can be in¬ 
corporated in the protected program to check 
whether it has been infected by a vims. 

Several HASP keys can be connected one 
behind the other. Small physical size ensures 
maximum convenience for your customers. 

NETHASP- THE ULTIMATE 
SOFTWARE PROTECTION 
FOR NETWORKS 

\/ Only one NetHASP key is needed to run a 
protected program from any station in a network. 
NetHASP provides full support for protecting DOS 
and WINDOWS software under network 
environments, including Novell dedicated & 
non-dedicated servers, Lan Manager, Lantastic, 
Banyan, DLink, and NET-BIOS based LANs. 


LISTEN TO THE EXPERTS: 

In all the products we tested, except the HASP, 
we could see through the encrypting and 
questioning procedures... and crack them. 

CT Magazine (Germany) 
MemoHASP: ...of all the protection devices tested 
is without any doubt, the one which combines 
the best features. 

PCompatible (Spain) 

Trying to crack a program... that was protected 
utilizing all of HASP’S features - is like searching 
for the Holy Grail. 

Micro Systems (France) 

PC dongles... come with varying claims as to 
their transparency. The majority suffer from 
problems when a printer is connected... the 
DESkey and HASP-3 are not affected... 

Program Now (Britain) 
Of all keys tested, HASP is the most ambitious 
one... the quality of HASP manufacturing seems 

pYfplIpnt 

PC Compatible (France) 

An easy to use software protection system for 
the Macintosh, which ensures an effective 
defense against software piracy... 

Life is difficult for pirates... MacHASP is an 
optimal protection method, for the 
programmers... and for the users... 

Bit Magazine (Italy) 


OPERATING ENVIRONMENTS 

PC: DOS, Windows, Windows NT, Win 32s, 
OS/2, SCO Unix, SCO Xenix, 
Interactive Unix, AIX, Autocad, 

DOS Extenders, LANs 
MAC: Mac, PowerMac (ADB port) 

NEC: DOS, Windows 
AMIGA 

AND THE BOTTOM LINE: 

We offer some of the most competitive prices 
in the market. Since 1984, nearly one million 
HASP keys have enabled thousands of software 
developers, in more than 6(1 countries, to 
protect their software. 

Order your HASP Developer’s Kit today. 

1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 

North Aladdin Software Security Inc. 

America Tel: (800)2234277,212-564 5678 

Fax: 212-5643377 
E-mail: sales@hasp.com 

Inti. Office Aladdin Knowledge Systems Ltd. 

Tel: 972-3-537 5795, Fax: 972-3-537 5796 
E-mail: aladdin@aladdin.co.il 

United Aladdin Knowledge 

Kingdom Systems UK Ltd. 

Tel: 0753-622266, Fax: 0753-622262 

France Aladdin France SA 

Tel: 140 85 98 85, Fax: 1412190 56 


member of 



I Australia Conlab 3 8985685 ■ Benelux Aladdin Benelux 080 782098 ■ Czech Atlas 2 766085 ■ Chile Micrologics 2 222 1388 
| Denmark Berendsen 39 577100 ■ Egypt Zeineldein 2 3604632 ■ Finland ID-Systems 0 870 3520 ■ Germany CSS 201 278804 
I Greece Unibrain 1 6856320 ■ Italy Partner Data 2 26147380 ■ Japan Athena, 3 58 213284 ■ Korea Dae-A 2 848 4481 
I New Zealand Training , 4 5666014 ■ Poland Systhenn 61 475065 H Portugal Futurmatica 1 4116269 I South Africa D Le Roux, 11 886 4704 
| Spain PC Hardware, 3 4493193 • Switzerland Opag 61 7169222 ■ Taiwan Teco 2 555 9676 ■ Turkey Mikrobeta 312 467 7504 


□ Request Reader Service #168 □ 


© Aladdin Knowledge Systems Ltd. 1985-1994 ( 9 . 94 ) 








of the CDynLinkLibrary being destroyed. If the match is 
TRUE, the next CDynLinkLibrary in the linked list is placed at 
the head of the list. If this test fails, then each CDynLinkLi¬ 
brary in the list is checked in turn until the current CDyn¬ 
LinkLibrary is found or the end of the list is reached. If 
found, the CDynLinkLibrary is unlinked from the list. 

There is a very obvious drawback here. This architec¬ 
ture does not support multiple applications linking to an 
extension DLL. The CMyDynLinkLibrary pointer would need 


to be maintained in a task-specific context for multiple ap¬ 
plications to use the DLL. However, multiple DLLs can use 
this DLL where the InitDLLO and ExitDLLO can be called 
multiple times from other DLL initialization and exit rou¬ 
tines. My DLL is designed with 'loadable' features as its 
goal, such as an MDI application's different features or 
document types (CMultiDocTemplate), or configuration based 
upon a user's security profile, but that is another story. □ 


Figure 3 Implementation of derived library class 

CMyDynLinkLibrary::CMyDynLinkLibrary(AFX_EXTENSION_MODULE& state) 

: CDynLinkLibrary(state) 

{ 

} 

} 

else 

{ 

while(prev) 

{ 

i f (((1onglnext) == ((long)this)) 


// ***** This destructor does what MFC forgot to do -- ***** 

( 

// ***** remove the library from the app’s list. ***** 

DLLAPI CMyDynLinkLibrary::~CMyDynLinkLibrary(void) 

{ 

CDynLinkLibrary* prev= NULL: 

prev->m_pNextDLL = next->mj>NextDLL; 
break; 

) 

prev= next; 

CDynLinkLibrary* next= NULL; 

next= prev->m pNextDLL; 

prev= _AfxGetAppData()->pFirstDLL; 

} 

next= prev->m_pNextDLL; 
if(prev) 

{ 

if(((long)prev) == (Uong)this)) 

{ 

_AfxGetAppData()->pFirstDLL = next; 

) 

} 

} 

/* End of File */ 


Instant Windows Integration for 
DOS and Host Legacy Applications. 



File Edit Formula 


patient Statistics 


Frank Adams 


P- 22441660 


Patient Number 


sonal 


LNAME: 


FNAME: 

CITY: SEMI 
7 TEL: <444>433-9916 SS NO: 555- 


AGE GROUP: 26 


2/19/65 


NT: N/A <N/A N Y> 


RATE: 1 


RELIGIj 


REIMB: 3 REF SOURCE: 5 


DEPENDENCY 


Microsoft Excel - WT_SPEC1.XLS 


THE ADALLAPI AND HILTON COUNTY ME DICAL SERVICE 

Patient Record 


PA'i ATUS: 2 
ADM AG: 3 


Ami Pro - [ADAM111 3 


Frame 


November 13, 

Frank Adams 
51455 Maple Avenue 
Forest KS 97017 
Dear Mr. Adams, 

I have tried, unsuccess 


h you by phone se 
60 days old. 

Ei^^^This actr 


only 

Call for OEM and resale options. 


O It’s automatic! Simply press a hotkey from 
within any program running in a DOS-box 
under Windows... and dynamically produce 
formatted and merged Windows documents. 
No more need to re-kev data ... 

No more need to cut and paste ! 

• Dynamically integrates DOS, UNIX, VMS, 
MVS... literally any application running in a 
DOS-box... with the Windows word processors, 
spreadsheets and databases of your choice! 

• Merges multiple records (and creates multiple 
Windows documents) in a single process. 

• Automated screen definition process. Define 
“database” fields on any screen in minutes. 

• Optional output to an ASCII comma-delimited file. 

• No TSRs. Uses VxD technology. 

...from WINGate Technologies 
the producers of the industry-leading 
Windows-DOS interprocess communications toolkits: 
WINGate and RohinHood 

High Street Ct. Suite 303 Morristown NJ 07960 
800-WINGate (201)539-2727 Fax (201 )539-2838 
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MFC Programming 


Mixing DDE and VBX 
Controls in MFC Programs 

Paul A. Scholz 

Object Linking and Embedding (OLE) is getting lots of attention these days 
from both the computer press and application developers, but Dynamic Data 
Exchange (DDE) is still the primary standard for simple interprocess communica¬ 
tion between Windows applications. While DDE may be the trailing edge of 
Windows technology, programmers still have to support DDE to maintain com¬ 
patibility with legacy applications, particularly those which involve network 
data transfer (not yet supported by OLE). 

Unfortunately, the designers of the Microsoft Foundation Classes (MFC) ig¬ 
nored DDE during design and implementation of the MFC, perhaps hoping that 
DDE would be quickly supplanted by the OLE standard. While DDE functions 
are still available to MFC programmers through the Windows SDK, there is a 
basic incompatibility between DDE and Visual Basic extension (VBX) controls in 
an MFC-based Windows program. MFC programmers who attempt to use DDE 
and VBX controls in the same program are greeted with the following error 
during compilation: 

error C2371: 'HSZ' : 
redefinition; different basic types 

The problem results from a naming conflict between the Dynamic Data Ex¬ 
change Management Library (DDEML) and VBX controls. The conflict arises be¬ 
cause both use the HSZ data type (handle to a string that is Mi-terminated), but 
each is defined differently. In the MFC header file afxext.h, HSZ is defined to be 
a BPSTR FAR* to support the Control Development Kit, while in the ddeml.h, HSZ is 
defined through the windows.h DECLARE_HANDLE32 macro, which resolves into a 
DUORD. 

Microsoft is aware of this conflict and has published the following 
workarounds: 

• Separate the DDEML and VBX code into different files to prevent afxext.h 
and ddeml.h from being included in the same source file. Or, 

• Use # define N0_VBX_SUPP0RT in the file that implements DDE. This will cause 
the compiler to use DDEML's definition of HSZ. 

The first solution, separating DDEML and VBX code into separate modules, is 
unwieldy, given the Smalltalk-like document-view-controller architecture of the 
MFC. The second solution, defining the N0_VBX_SUPP0RT compiler flag, is fine un¬ 
less you want to use VBX controls, which almost everyone does because of the 
productivity leverage they provide. 


Paul Scholz is a Windows software and simulation consultant in Dayton, Ohio. He is 
the author of the DDE Manager for Visual C++, a set of MFC classes which allow simul¬ 
taneous client/server DDE functionality. He may be reached at CompuServe 
74710,2752. 
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Windows 3.1 SDK 


File Edit Bookmark Help 

Contentsf Search | Back | History ] <L< ] >> „| 


Up 


! Group jOygivf* 



CreateRoundRectRqn (3.0) 


<^HRGN CreateRoundRectRg n (/?Z effReci nTopReci nRightRect nBattomReci p 
nVVMhEf/ipse, nHeightE/fipse ) 


Annotate 


Annotation: 


Cancel 


This function has a bug. It will produce a GP fault if the region 
rectangle is empty (either nLeftRect equals nRightRect. or nBottomRect 
equals nTopRect). About the only workaround is to create a wrapper 
function that first checks whether the rectangle is empty. 

Reference: p67. June 1994 Windows/DOS Developer's Journal 
Submitted by Chris Mason 

[Add this annotation to your own online API help file by pressing Alt-E-A] a LjT^PV, 


| Save ~| 


Fortunately, there is a much sim¬ 
pler solution which allows MFC pro¬ 
grammers to freely mix DDEML calls 
and VBX controls in an MFC pro¬ 
gram. All you need to do is change 
the HSZ data type in the ddeml.h 


header file to something else, HSZDDE 
for example. The steps to do so are 
simple: 

• First, make a copy of ddeml.h, call¬ 
ing it say, ddemll.h. ddeml.h is 
found in the \msvc\include subdi¬ 


rectory. After you modify the 
copy, you may leave it in the 
\msvc\include subdirectory so that 
all your MFC programs have ac¬ 
cess to it. 

• Second, using your favorite editor 
(the Visual C++ editor is fine for 
this), simply do a global search on 
ddemll.h and replace all occur¬ 
rences of HSZ with HSZDDE. Make 
sure you match case and replace 
whole words only, or you will in¬ 
advertently change items in 
ddeml.h which should not be 
changed. For safety, use the Find- 
Next option instead of Replace-All. 
This will allow you to examine 
each change and accept or reject 
it as appropriate. 

• Third, when writing your DDEML 
calls, just use the HSZDDE type 
where the SDK documentation 
calls for an HSZ type. Because this 
resolves into a DUORD inside the 
DDEML, this works without any 
problems. For example, your DDE 
callback function prototype before 
the change might look like this: 

(continued on page 14) 


Full-Text Toolkit 


The InfoLink Library adds high performance 
text indexing and retrieval to your application. 

T It's Fast! Boolean searches take less than one 
second, regardless of the size of the database. 

▼ Boolean, Phrase, and Proximity searches can be 
performed. Nested searches and wild card searches 
are also available. 

▼ Low Overhead indexes (with all words indexed) are 
typically 10% of the size of the original text. 

T DOS, Windows and MAC platforms. 

Great for applications in Visual Basic, Visual C++, C++, or C. 

Info Link 

. TECHNOLOGIES 


750 N. 200 W. Provo, Utah 84601 
(801) 375-7507 Fax (801) 375-7537 


1 - 800 - 426-3277 
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Whether you're headed to Chicago, Daytona, 

OR POINTS UNKNOWN, SUMMTT BASICSCRIPT HELPS 
YOU ARRIVE IN STYLE 

The BasicScript Toolkit makes it easy and Dav,0 " a 

economical to add an award-winning scripting 
language to your application. 
h Easy-to-use APIs make it simple to integrate 
BasicScript into your application using C, C++, Visual 
Basic, or other programming tools. 

B Compatible with the syntax of Microsoft Visual Basic 
and Visual Basic for Applications (VBA). 
b Controls OLE Automation objects in Windows, Win32, Netware 
and Macintosh applications. 

b Extensibility architecture allows you to add your own 
keywords to the BosicScript language, 
a Available for Windows 3.1, Windows 95 "Chicago", Windows NT 3.5 
"Daytona", MS-DOS, SunOS, Solaris 2.x, HP-UX, AIX, SCO UNIX, Ultrix, 

IRIX, Macintosh, Power Macintosh, NetWare and OS/2. 
b Runtime can be redistributed by your customer without royalties. 
b End-user scripting tools (Script Editor/Debugger, Dialog Editor and Script 
Recorder) allow you to offer o complete Integrated Development 
Environment (IDE) for scripting, 
a Free technicol support, comprehensive documentation, ond numerous code 
samples keep your engineering costs to o minimum. 
b Licensed by Symantec, Delrina ond other leading software companies. Named 
PC Magazine Editors' Choice omong cross-opplicotion mocro languages. 

B Flexible licensing terms mean you con afford the finest scripting language on the 
market today. 

Call today for your FREE | 


CHOICE 

ftAwryS, 1994 
Ihe Norton Desktop 
3.0 for Windows 


• S * U* M* I* T 


I 


EVALUATIOtKOPY^l 5-677-9000 1 


Summit Software Company Fax: 315-677-3224 Internet: info@summsoft.com CompuServe: 71211,3504 
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DISK 

INCLUDED 


Peter Gulutzan 
Trudy Pelzer 


Embedded SQL in C 


Optimizing SQL 

by Peter Gulutzan and Trudy Pelzer 

Optimizing SQL explains the basics 
and subtleties even some experts 
don’t know. Careful comparisons 
demonstrate how to improve SQL 
performance and 17 rules-of-thumb 
guide efficient applications. 


Learn ODBC and dynamic 
(machine-generated) 
embedded SQL 

This book explains Microsoft’s Open Database 
Connectivity interface. You will also learn how to 
embed SQL in C, how and when to use indexes, and 
coding for portable applications. 



OPTIMIZATION RULE-OF-THUMB *1 


If you have two or more ANDerf expressions put 
the most limiting expression first. 


Query A 
SELECT * 

FROM ITEMS 
WHERE PRICE = 600 


Query B 
SELECT * 

FROM ITEMS 
WHERE .35 = DISCOUNT 


Query A 

DBMS #1 100% 

DBMS #2 100% 

DBMS #3 100% 


Query B 
200 % 
200% 
200 % 



Macbeth 

Thane of Glamis 

Macbeth 

Thane of Cawdor 

Macbeth 

King of Scotland 

Macduff 

Thane of Fife 


Optimizing SQL 

also contains these programming aids: 

■ A summary of SQL commands. 

■ A "Hello World 1 ' program demonstrating static 
embedded SQL. 

■ A lengthy sample program in dynamic 
(machine-generated) embedded SQL. 

■ A "toolkit" program for checking index status. 

■ A complete sample ODBC application. 

■ 17 rules-of-thumb for more efficient SQL. 

■ A free enclosed diskette with: 

- All programs in the text 

- Sample database libraries for DOS and 
Windows 

- An embedded SQL Precompiler 


Order Your Copy Today! 

Use code V01 for Optimizing SQL with disk. 


Book with disk 

$ 34 §§ 


plus shipping 


O 

i 

DISK 

INCLUDED 



Technical 

Books 


913-841-1631 
FAX: 913-841-2624 
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W/DDJ SDK Annotation #20 


*1 

--- 



HDDEDATA FAR PASCAL _export 
StdDDECal1back(WORD wType, 

WORD wFmt, 

HCONV hConv, 

HSZ hszl, HSZ hsz2, 
HDDEDATA hData. 
DWORD dwDatal. 

DWORD dwData2); 

After the change, your DDE callback 
prototype would look like this: 

HDDEDATA FAR PASCAL _export 
StdDDECal1back(W0RD wType, 

WORD wFmt, 

HCONV hConv, 

HSZDDE hszl, 

HSZDDE hsz2, 
HDDEDATA hData, 
DWORD dwDatal, 

DWORD dwData2); 

• Fourth, make sure you include 
your new ddemll.h file instead of 
the old ddeml.h file. 

That's all there is to it. Now you 
can freely mix DDEML calls and VBX 
controls in your MFC programs. Good 
luck, and happy programming! □ 





THE PRESENTATION GRAPHICS SDK 

ThE ULTIMATE BU5IME55-GRAPHIC5 LIBRARY! USED IM ALDUS PERSUASIOn 3.0, COREL CHART, MACROMEDIA ACTION! 


Windows 3.1, Windows tIT, Macintosh and 05/2 2.x versions 
available now! Ask about UHIX and PowerMac availability! 

Call 1-800-227-2500 MOW for a free demo disk! 


Palisades Software 

15332 Antioch St. #357 
Pacific Palisades, Ca 90272 
Fax (310) 459-5822 
CompuServe: 76117,2771 




• 50+ Standard 
graph types, 
including bar, 
line, area, pie, 
scatter, hl-lo, 
table and 
spectral 
charts. 

• Log/Log, Bl-Polar and Dual-Y chart options 

• 20+ types of real 3D charts 

• 3D ViewTool let's you rotate, zoom, pan, 
distort your 3D charts with one easy con¬ 
trol. 


• On-screen editing of 
chart elements. 

• Gradient Fills, Drop 
Shadows, Pictograms, 
etc. 

• Annotation Layer 

• Undo/Redo any action 

• Complete Data 
Manager imports files 
from Excel, Lotus 123, 
xBase and A5CII. (Can 
also create DDE Links!) 


Many statistical functions built-in!, 

International support 

Straightforward C function calls control all aspects of 
library. 

Compatible with any system that can access DLL's. 
Comes with sophisticated template-editing software so 
you can create Impressive charts with a minimum of pro¬ 
gramming. 

What the reviews say... 

"great charting" and, "Charting is so good that this module competes favoribly against DeltaGraph Pro." - Infoworld 
"Action for Windows charting facility tops most multimedia presenters" HewMedia 

"CorelChart is a charting module that's good enough to compete with the charting features in traditional presenta¬ 
tion packages." - MultiMedia World 
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MFC Programming 


OLE 2 Automation with Visual C++ 

Louis and Karen Ross 


OLE 2 automation offers a standard interface for allowing other applications 
to manipulate your application directly. For example, if you write a spreadsheet 
that supports OLE 2 automation, you could allow someone using Visual Basic 
(which knows about the OLE 2 automation interface) to write programs that 
start your application and then use OLE 2 automation to access whatever func¬ 
tionality you provided, such as creating and manipulating spreadsheets. 

This article explains how to create an OLE 2 automation server application 
called AutoEditor. AutoEditor is a simple text editor that can be used as an 
independent, standalone text editor - or called from an OLE 2 automation 
client (such as Visual Basic 3.0). The AutoEditor example illustrates how to im¬ 
plement an OLE 2 automation server using MFC 2.5. i developed AutoEditor 
using Visual C++ 1.5, which includes MFC 2.5 and tools for generating skeleton 
applications and managing classes. 

About OLE 2 

If you place a set of C++ classes in a DLL, export them, and compile with 
Visual C++, then Borland C++ applications cannot access them. The two com¬ 
pilers do not use the same name-mangling scheme, nor precisely the same 
way of laying out objects in memory. At the lowest level of OLE 2 is the Com¬ 
ponent Object Model, a specification for creating a standardized form of object 
so that other code can access it. Just as the Pascal calling sequence provides a 
standard way to access DLL functions, the Component Object Model provides a 
standard, if more complex, way to access objects that other applications and 
DLLs export. 

Physically, OLE 2 is a set of DLLs that contain exported functions you can 
call. However, much of the functionality of OLE 2 is available via OLE 2 objects 
(sometimes called Windows objects) rather than DLL functions. You can use 
OLE 2 functions to obtain pointers to Windows objects; you can view these as 
arrays of function pointers that are analogous to C++ virtual class member 
functions. To use a pointer to a Windows object, you have to know what the 
functions in the array of function pointers do, what arguments they take, and 
so on. In OLE 2 parlance, this array of function pointers is called an interface. 
An OLE interface is a binary standard for interacting with objects. 


Lou Ross has BS and MS degrees in Computer Science. He has developed DOS and 
Windows communications software for eleven years. For the past year, he has used 
OLE 2, MFC, and Visual C++ to create applications at Wall Data, Inc. Karen Granger 
Ross has a BA in Writing and has been documenting networking software for seven 
years. The opinions expressed in this article are Lou and Karen's and do not necessarily 
reflect the opinions of their employers. Send correspondence to Lou via Internet at 
lross@hq.walldata.com or via CompuServe at 70671,2311. 
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This is your career. 



This is your career 
on PowerBuilder Desktop. 
Any questions? 
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the desktop version of PowerBuilder®, 
the client/server development tool 
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PowerBuilder Desktop’s integrated 
client/server architecture and rich object language 
enable you to build powerful Windows" applications 
that incorporate data from our built-in Watcom" 
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Fox® and dBase® You can also extend 
your environment with popular third- 
party add-ons like FUNCky? And we 
offer all the support and training services 
you need to get your career cooking fast. 
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CompUSA, Egghead, Micro Center or call 

Powersoft "at 1-800-866-8623. Powersoft 

Building on the power of people. 
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OLE 2 defines a large number (62) of different inter¬ 
faces for specific purposes, such as implementing per¬ 
sistent storage, in-place editing, and so on. For many of 
these interfaces, the intent is that you will create your 
own Windows object that supports the interface but that 
provides functionality specific to your application. In other 
words, your Windows object will support the same num¬ 
ber, order, and types of functions that the interface speci¬ 
fies, but your implementation of one or more of those 
functions will be different from that of some other Win¬ 
dows object that supports the same interface. It is possible 
for you to invent a new interface for some custom Win¬ 
dows object, but only Windows applications that were 
compiled with information about your interface will be 
able to make practical use of your new object. 

You can, however, use OLE 2 to provide Windows ob¬ 
jects that have completely customized functionality yet 
can be accessed by general-purpose tools. OLE 2 automat¬ 
ion is a set of interfaces that let you define and access 
Windows objects that contain various kinds of data and 
perform arbitrary functions. By creating OLE 2 automation 
objects that abide by this interface, you make them avail¬ 
able to other tools, such as Visual Basic. A Visual Basic 
application could then, at runtime, determine what OLE 2 
automation objects your application exports and what 
functions and data those objects support; the Visual Basic 
application could then make use of those objects. 

Supporting OLE 2 automation in your application re¬ 
quires a good deal of code. Fortunately, MFC 2.5 has 


Listing 1 cdatea.h —Automation class header 
generated by ClassWizard 


///////////////////////////////////////////////////////////////////////////// 

// CDateTimeAuto command target 

class CDateTimeAuto : public CCmdTarget 
{ 

DEC LARE_DYNCREATE(CDateTimeAuto) 
protected: 

CDateTimeAutoO; // protected constructor used by dynamic creation 

// Attributes 
public: 

// Operations 
public: 

// Implementation 
public: 

virtual -CDateTimeAutoO: 
virtual void OnFinalReleased; 

protected: 

// Generated message map functions 
//{{AFX_MSG(CDateTimeAuto) 

// NOTE - the ClassWizard will add and remove member functions here. 
//}}AFX_MSG 
DECLARE_MESSAGE_MAP() 

DECLARE_OLECREATE(CDateT i meAuto) 

// Generated OLE dispatch map functions 

//{{AFX_DIS PATCH(CDateT1meAuto) 

afxjnsg long GetDateO: 

afxjnsg long SetDatedong NewDate); 

afx_msg long GetTimeO; 

afxjnsg long SetTimedong NewTime); 

//}}AFX_DISPATCH 
DECLARE_DISPATCH_MAP() 

}; 

///////////////////////////////////////////////////////////////////////////// 

/* End of File */ 


Emacs for Windows 


WinEmacs is a fully functional Windows 3.1 
version of the industry standard program editor 
Gnu Emacs, version 19.6. 


WinEmacs has these extended features 


• Separate buffers in different windows 

• Menu and drop-down menu bar 

• Multiple font size and type support 

• Cut and paste mouse support 

• Support for Text and Binary files 

• Clipboard support 

• Binds any arbitrary combination of key and 
key modifers to Emacs Lisp code 

Contact Pearl Software at pearlsoft.com (e-mail), 
510-652-4361 (voice) or 510-652-4362 (fax) for more 
information. Supported version costs $199. 

Call 1-800-WIN-EMACS 

We also provide EMACS consulting services. 

Pearl Software Corporation 

2000 Powell Street #1200, Emeryville, CA 94608 
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RS232-Toolkit, SuperCom 
for DOS, Windows, NT, OS/2 


for MS C/C++, Visual C++, Turbo/ i 
Turbo/Borland Pascal (incl. Protected- 


orland C/C++, 
tye), IBM C/C++ 

SuperCom is the development tool for e^Ecfeng serial communi¬ 
cation software. That means high d^a ^wwty and highest trans¬ 
mission speed. The SuperCom librari^gare fast even in a multi¬ 
tasking operating system like Windows NT or OS/2. 

The same programming interne loused among different 
languages and operating sv§t 



Interrupt driven: transmission, receptidf 
modem status. Up to 115,200 bps. 

• UARTS: 8250,16450,16550 FIFQ 

• Simultaneous C0M_1..COM J 

• Direct register programming^] 

• Flow control: RTS/CTS*.Dtl 
user defined. ANSLTr 
Protocols: ASCII, XfifcaSifrXMODEM/CRC, 
YMODEM, YMODEMffiATCH, ZMODEM. 

• Timer, Ctrl-Break and Exception handling. 
Multitasking support (Windows, NT, OS/2) 
Protected Mode Interface, 386-Technology. 

• User Event Routines under DOS and Windows. 
Under Windows user can even post messages to 
the application using PostMessage. 


Language independent DLL (Windows, NT, OS/2) 
which can be used for simultaneous transfers by 
applications. 

Multiserial board support (AST, ARNET, DigiBoard 
PC/X, HOSTESS, STARGATE). Reduces loading of 
CPU through support of intelligent DigiBoard PC/Xe, 
PC/Xi boards (up to 112 ports’!!!). 

Modem support, RS422/485 support. 

Support for 286 DOS-Extender (e.g. PharLap) 

No resident drivers*. Just link the LIB. No Royalties. 
FREE technical support. FREE demo 
Full source code (C or Pascal and optimized ASM). 
SuperCom++ (C++ or Pascal OOP) included. 
Protected Mode Interface (Windows) included. 


C/C++ or Pascal package forDOS only $299 
C/C++ or Pascal package forWindows, OS/2 orNT each $399 
C/C++ or Pascal combo pack forDOS+Windows only $528 
C/C++ or Pascal combo back forWindows+NT only $598 
C/C++ combo pack forDOS+Windows+OS/2 only $799 
C/C++ combo pack forDOS+Windows+NT only $799 
C/C++ combo pack forDOS+Windows+OS/2+NT only 


only $999 



’Under DOS and Windows 3.x 
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ADONTEC Computer Systems Ltd. 

Hoelderlinstr. 32 
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Phone: 49-7043-40449 
FAX: 49-7043-40440 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 

Phone: 1-707-887-3400 
FAX: 1-707-887-1015 
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Listing 2 cdatea.cpp — Automation class 
implementation generated by Class Wizard 


ifinclude "stdafx.h” 

^include ''cdatea.h'' 

lifdef .DEBUG 
tadef THISJILE 

static char BASED.CODE THIS_FILE[] = _FILE_; 

#endif 

///////////////////////////////////////////////////////////////////////////// 

// CDateTimeAuto 

IMPLEMENT_OYNCREATE<CDateTimeAuto, CCmdTarget) 

CDateTimeAuto::CDateTimeAuto() 

( 

EnableAutomationO; 

// To keep the application running as long as an OLE automation 
// object is active, the constructor calls AfxOleLockApp. 

AfxOleLockAppO; 

) 

CDateTimeAuto::~CDateTimeAuto() 

( 

// To terminate the application when all objects created with 
// with OLE automation, the destructor calls AfxOleUnlockApp. 

AfxOleUnlockAppO; 

) 

void CDateTimeAuto::0nF1nalReleasei) 

{ 

// When the last reference for an automation object is released 
// OnFinalRelease is called. This implementation deletes the 
// object. Add additional cleanup required for your object before 
// deleting it from memory. 


come to the rescue. MFC 2.5 encapsulates most of the OLE 
2 functionality you need, defining classes for most OLE 2 
features. These classes allow you to create OLE 2 applica¬ 
tions without dealing with the complexity of OLE 2. 

The IUnknown Interface 

Each OLE 2 interface's name starts with an T, and the 
T stands for 'interface.' At the heart of each OLE 2 inter¬ 
face is the [Unknown interface. If you have a pointer to a 
Windows object, the first few slots in the table of function 
pointers it points to always contain the functions specified 
by the IUnknown interface. 

The IUnknown interface has three methods: Querylnter- 
faceO, AddRefO, and Release!). QuerylnterfaceO allows an 
object to access another interface by specifying the inter¬ 
face's ID and a pointer to where the resulting address will 
be stored. Once a client of the object has the IUnknown 
interface pointer, it can obtain all other interfaces through 
that pointer. Actually, a server does not need to imple¬ 
ment all interfaces. Most servers only support the inter¬ 
faces that are meaningful to the server application. 
AutoEditor implements IUnknown and IDispatch only. 
IUnknown is used in every OLE 2 application, and IDis¬ 
patch is the automation interface pointer. 

So, naturally, the next question is, "How do I get 
IUnknown to start with?' There are a couple of ways to 
perform this magic, but the basic approach is the same. 
The application first calls OleBuildVersionO to verify the 
version of the OLE 2 DLLs, then calls OlelnitializeO to 


C and C++ DOCUMENTATION 


C-METRIC™ ($59) - Complexity/Quality 

• Calculates "cyclomatic" path complexity for functions and system 
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r ff***.*... 
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• Produces class-hierarchy tree-diagram for C++ classes 

C-BROWSE™ ($free in C-DOC) - Windows Tree Viewer 
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•All 5 programs integrated as 1 overall C-DOC program 
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S.I.P.-Uninstall for Windows 

+ analyses all changes of an installation. 
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installation. 

+ uninstalls 100% of all changes! 

(Deleted or changed files must have been saved with S.I.P.-Uninstall before the installation!) 
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Illustrated C 

By Leor Zolman 

Illustrated C explores the construction of 
several different applications, from start 
to finish. Through a focus on building 
useful, practical programs, this book 
gives the C programmer the “why and 
how" of application design and 
development. Each program is 
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readable style. Illustrated C is a tutorial 
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Windows Custom Controls 

By William Smith & Robert Ward 
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powerful and usable custom controls for 
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to many commercially available kernels. 
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Object-Oriented Software Engineering 

By Steve Halladay & Michael Wiebei 

This book explains how to engineer 
applications to minimize cost. The 
concise method comprises six phases 
covering the complete software life cycle 
from initial requirements to final 
maintenance. Each chapter discusses a 
major phase, explaining the concepts 
and demonstrating with examples. The 
authors demonstrate object-oriented 
principles for each phase of 
development. For precision, the design 
method is presented in a pseudocode 
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initialize OLE 2. Next comes a call to CoCreatelnstanceO, to 
create an instance of the specified object class. CoCreateln¬ 
stanceO in turn calls CoGetClassObjectO, which loads and 
connects to an object. Finally, CoCreatelnstanceO calls the 
class factory (ICIassFactory) Createlnstance method to cre¬ 
ate an uninitialized instance of an object. 


The OLE Automation Interface 

OLE 2 automation allows an application to expose 
methods (functions) and properties (variables and data). 
Exposing methods and properties means making them 
available so other applications can use them. An applica¬ 
tion that exposes its methods and properties is called an 


Listing 2 continued 


delete this; 

) 

long CDateTimeAuto;:GetDate{) 

{ 

// TODO: Add your dispatch handler code here 

BEGIN MESSAGE MAPECDateTImeAuto. CCmdTarget) 

return 0; 

//{{AFX MSG MAP(CDateTImeAuto) 

) 

// NOTE • the ClassWIzard will add and remove mapping macros here. 


//}}AFX MSG MAP 

long CDateTImeAuto::SetDate(long NewDate) 

END_MESSAGE_MAP() 

( 

// TODO; Add your dispatch handler code here 

BEGIN DISPATCH MAP(CDateTimeAuto. CCmdTarget) 

return 0; 

//{{AFX DISPATCH MAP(CDateTlmeAuto) 

i 

DISP FUNCTION(CDateTimeAuto. "GetDate", GetDate, VT 14, VTS NONE) 


DISP FUNCTIONfCDateTimeAuto. "SetDate”, SetOate, VT 14, VTS 14) 

long CDateTimeAuto::GetTime() 

DISP FUNCTIONCCDateTimeAuto. "GetTime", GetTime, VT 14, VTS NONE) 

{ 

DISP FUNCTION(CDateTimeAuto. "SetTime". SetTime, VT 14. VTS 14) 

// TODO; Add your dispatch handler code here 

//»AFX DISPATCH MAP 

return 0; 

END_DISPATCH_MAP() 

} 

IMPLEMENT OLECREATEtCDateTimeAuto, "DateTimeAuto", 0x5ada6040, 0x7eld, 0x181b, 0x88, 

long CDateTimeAuto::SetTime(long NewTime) 

0xd7, 0x4, 0x2, 0x1 c, 0x0, 0x94, 0x2) 

{ 

// TODO; Add your dispatch handler code here 

///////////////////////////////////////////////////////////////////////////// 

return 0; 

// CDateTImeAuto message handlers 

} 

// End of File 
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automation server, or just a server. An application that 
calls the methods and properties is called an automation 
client, or just a client. The AutoEditor sample application in 
this article exposes a method called FileNewDocO. This 
method is 'exposed* because the Automation interface is 
exposed and because the method is part of the interface 
dispatch table. A client that has gained access to AutoEdi- 
tor's automation interface can call FileNewDocO to create a 
new document. 

You expose methods and properties by implementing 
an OLE 2 automation interface. The automation interface 
contains all of the common attributes that other OLE 2 
interfaces provide and is derived from an IUnknown inter¬ 
face, the base for all OLE 2 interfaces. After a client ob¬ 
tains the IUnknown pointer, the client can obtain the 
automation interface pointer (IDispatch) by calling Query In¬ 
ter faceO as follows: 

(continued on page 22) 


Listing 3 cdatea.odl — Automation class object 
description language file 


[ 

uuid(A3C6A020-F54C-701A-96F1-AA0004000704), 
helpstringCcdatea for Autoserv.") 

] 

library cdatea 
{ 

import!ib("stdole.tlb”); 

[ 

uuid(AD5622A0-F54C-701A-96F1-AA0004000704), 
helpstringCcdatea Interface") 

] 

dispinterface CDateTime 
{ 

properties: 

methods: 

[id(l)] long GetDateO; 

[id(2)] long SetDatel [in] long NewDate); 
[id(3)] long GetTimeO; 

Cid(4)] long SetTimeC [in] long NewTime); 

} 

} 


Listing 4 cdate.h — Automation class header 
generated by ClassWizard 


// Machine generated IDispatch driver class(es) created 
// with ClassWizard. 

/////////////////////////////////////////////////////////////////// 
// CDateTime wrapper class 

class CDateTime : public C01eDispatchDriver 
{ 

// Attributes 
public: 

// Operations 
public: 

long GetDateO: 

long SetDatedong NewDate); 

long GetTimeO; 

long SetTimedong NewTime); 

}; 

/* End of File */ 
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LPDISPATCH 1pIDispatch; 

HRESULT hr = Querylnterface( IID_IDispatch, 

(LPVOIO FAR*)&1pIDispatch ); 

QuerylnterfaceO takes two parameters: an interface ID and 
a far pointer to a far pointer to the interface. Here is the 
prototype: 

HRESULT Querylnterfacet REFIID riid, LPVOID FAR* ppvObj ); 

Why Is MFC a Must for OLE 2 Programming? 

In a nutshell, without MFC, developing OLE 2 applica¬ 
tions would be a nightmare. MFC greatly reduces the de¬ 
velopment necessary for an OLE 2 application. MFC 2.5 
implements the OLE 2 interfaces via C++ classes. 

Creating a container, server, or automation application 
is as easy as creating a class that is derived from the 
proper class and implementing a few functions. Seldom do 
you need to worry about the actual OLE 2 interfaces and 
APIs. Keep in mind, however, that a thorough under¬ 
standing of OLE 2, the Component Object Model, and OLE 
2 interfaces is an absolute must. I recommend a thorough 
reading of the OLE 2 specification, "Inside OLE 2," or OLE 2 
Programmer's Reference, volumes 1 and 2. 

Without MFC, the server would have to implement the 
OLE 2 automation interface and all of its member func¬ 
tions. These functions include: QuerylnterfaceO, AddRefO, 
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ReleaseO, GetTypelnfoCountO, GetTypelnfoO, GetlDsOfNamesO, 
and InvokeO. 

If you are curious about how much code these func¬ 
tions encompass, take a look at cmdtarg.cpp, oledispl.cpp, 
and oledisp2.cpp in the msvc\mfc\src directory. These files 
implement the functions; pack, unpack, and validate pa¬ 
rameters; allocate, copy, and deallocate string buffers; and 
set up proxies for passing the LPDISPATCH and LPUNKNOUN pa¬ 
rameters. 

Without MFC 2.5, a client would call most of these 
functions directly using the IDispatch pointer. In addition, 
the client would set parameters, create and pass a type 
definition list, allocate return value pointers, and pass the 
return value type. With MFC 2.5, a server application need 
only derive a class from CCmdTarget. CCmdTarget implements 
IDispatch. Now all that needs to be done is to add meth¬ 
ods and properties to the derived class. If you use Visual 
C++ 1.5, you can use ClassWizard to create the skeleton 
for the methods and properties, as well as add them to 
the dispatch table. 

cdatea.h (Listing 1), cdatea.cpp (Listing 2), and cdatea.odl 
(Listing 3) illustrate a class (CDateTimeAuto) generated with 


Listing 5 cdate.cpp — Automation class 
implementation generated by ClassWizard 


II Machine generated IDispatch driver class(es) created with ClassWizard. 

#include "stdafx.h" 

^include "cdate.h" 


//////////////////////////////////////////////////////////////////////// 
// CDateTime properties 

//////////////////////////////////////////////////////////////////////// 
// CDateTime operations 

long CDateTime::GetDate() 

{ 

long result: 

InvokeHelper(0xl, DISPATCH_METHOD, VTJ4, (void*)iresult, NULL): 
return result: 

} 

long CDateTime::SetDate(long NewDate) 

( 

long result: 

static BYTE BASED_CODE parms[] = 

VTSJ4; 

InvokeHelper(0x2, DISPATCH_METHOD, VTJ4, (void*)lresult, parms. 

NewDate): 
return result: 

) 

long CDateTime::GetTime() 

( 

long result; 

InvokeHelper(0x3, DISPATCH_METHOD, VT_I4. (void*)Aresult. NULL): 
return result: 

} 

long CDateTime::SetTime(1ong NewTime) 

{ 

long result; 

static BYTE BASED_CODE parms[] = 

VT$_I4; 

InvokeHelper(0x4, DISPATCH_METHOD, VTJ4, (void*)4result, parms. 

NewTime): 
return result; 

} 

// End of File 
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ClassWizard. This class is derived from CCmdTarget and con¬ 
tains four methods: GetDateO, SetDateO, GetTimeO, and 
SetTimeO. All of the necessary OLE automation code is in 
the CCmdTarget class. What is left to be implemented for 
this automation interface class is the actual methods, that 
is, the code to implement GetDateO, SetDateO, GetTimeO, 
and SetTimeO. The OLE 2 automation interface (IDispatch) 
is implemented in CCmdTarget and can be retrieved by call¬ 
ing GetIDispatchO. GetIDispatchO returns an LPDISPATCH, a 
far pointer to an IDispatch. 

With MFC 2.5, a client application creates a class de¬ 
rived from COleDispatchDriver. The class COleDispatchDriver 
contains all of the code necessary for a client application 
to locate, run, and access an auto¬ 
mation server application. The de¬ 
rived class needs to provide the code 
for each method and property that 
will be called. The code is actually a 
wrapper since the functionality re¬ 
sides in the server application. The 
wrapper merely provides easy access 
for client applications. 

cdate.h (Listing 4) and cdate.cpp 
(Listing 5) illustrate a class ( CDateTime) 
generated with ClassWizard. This 
class is derived from COleDispatch¬ 
Driver and contains four methods: 

GetDateO, SetDateO, GetTimeO, and 
SetTimeO. A client application could 
use the date and time functionality in 
the automation server by merely call¬ 
ing these wrapper functions within 
CDateTime. Note that CDateTime and 
CDateTimeAuto both contain the same 
methods. The difference is that 
CDateTime contains wrapper functions 
to call the methods in CDateTimeAuto. 

CDateTimeAuto is implemented in the 
server and is derived from CCmdTarget. 

CDateTime is implemented in the client 
and is derived from COleDispatch- 
Dri i ter. 

ODL (Object Description Language) 
files and TLB (Type Library) files are 
beyond the scope of this article's dis¬ 
cussion, but ODL files are text files 
that server application developers 
create to describe the methods and 
properties that the server's automat¬ 
ion interface will expose. A TLB file is 
an ODL file compiled using the Type 
Library Generator found in the OLE 2 
SDK. 

Sample OLE 2 Automation 
Server Application 

AutoEditor, the automation server 
application presented here, is a very 
simple text editor that exposes the 
most common attributes of a text 
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Listing 6 autosdoc.h — AutoEditor’s document 
class header file 


11 autosdoc.h : interface of the CAutoservDoc class 
II 

lllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll 

class CAutoservDoc : public CDocument 
{ 

protected: II create from serialization only 
CAutoservDoc!); 

DEC l_ARE_DYNCREATE(CAutoservDoc) 

// Attributes 
public: 

// Operations 
public: 


December 1994 












editor. You can open files, save files, create files, set text, 
get text, find strings, etc. AutoEditor even supports printing 
and print preview, but not help. The purpose of this appli¬ 
cation is to illustrate OLE 2 automation from the server 


word processor, so don't expect much fancy functionality. 
The server can be manipulated from any OLE 2 automat¬ 
ion client, such as Visual Basic 3.0, or you can run it as a 
standalone editor. 


point of view, not create a replacement for your favorite 



Figure 1 ClassWizard dialog for CDateTimeAuto 
class 
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I created AutoEditor using Visual C-i—t- 1.5 and MFC 2.5. 
I used AppWizard to generate the skeleton. I enabled the 
OLE 2 automation check box; to keep things simple, I en¬ 
abled no other OLE 2 functions. 

AutoEditor uses the CEditView MFC class for its derived 
view class, CAutoservVieu. The CEditView class handles all of 
the edit control messages and functions. I added 
FindNextO to CAutoservView to facilitate the "Find Next' fea¬ 
ture. I found that the easiest way to do this was to call 
OnFindNextO, which is a protected member function of 
CEditView. 

Coding the AutoEditor Document Class 

AutoEditor's document class, CAutoservDoc, is derived 
from CDocument. The CDocument MFC class enables the basic 
functionality of a document, in the MFC world, documents 
represent the data the user typically deals with, saves to a 


Listing 6 continued 


II Implementation 
private: 

CString m_str$earchText: 

public: 

virtual -CAutoservDocO; 

virtual void SerializefCArchive& ar): // overridden for document i/o 
#i fdef JEBUG 

virtual void AssertVal1d() const; 
virtual void DumpfCDumpContextS dc) const: 

fendlf 

protected: 

virtual BOOL OnNewOocumentO; 

// Generated message map functions 
protected: 

//{{AFX_HSG(CAutoservDoc) 

// NOTE - the ClassWizard will add and remove member functions here. 
// DO NOT EDIT what you see in these blocks of generated code ! 
//}}AFX_MSG 
DECLARE_MESSAGE_MAP() 

// Generated OLE dispatch map functions 

//{{AFX_DISPATCH(CAutoservDoc) 

afxjsg BOOL FileNewDocO; 

afx_msg BOOL FileOpenDocILPCSTR pDocName): 

afxjnsg BOOL FileSaveDocO; 

afxjnsg BOOL Fi1eSaveDocAs(LPCSTR pNewOocName); 

afxjsg BOOL FileCloseDocO; 

afxjsg BOOL EditUndoO; 

afxjsg BOOL EditCutO; 

afxjsg BOOL EditCopyO; 

afxjsg BOOL EditPasteO; 

afxjsg BOOL EditFIndCLPCSTR pSearchText); 

afxjsg BOOL EditFindNextO; 

afxjsg BSTR EditGetTextO; 

afxjsg BOOL EdftSetTextELPCSTR pText); 

afxjsg BSTR EditGetSelectedTextO; 

//}} AFX_DISPATCH 
DECLARE_DISPATCH_MAP() 

1: 

lllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll 
I* End of File */ 
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file, and later retrieves from the file. CDocument allows docu¬ 
ments to be created and data to be read from and written 
to files. The CDocument class has an associated template 
that specifies the resources that the documents use, in¬ 
cluding menus, icons, strings, bitmaps, dialogs, accelerator 
keys, and so on. 

Simple applications that implement one automation in¬ 
terface usually do so within the document class. Complex 
applications like Microsoft Excel 5.0 implement hundreds 
of automation interfaces and thus are more likely to im¬ 
plement a class for every automation interface. 

Code Generated by AppWizard 

AppWizard inserts a dispatch table 
into your implementation file (.cpp). 

ClassWizard manages this dispatch 
table (you probably should not edit 
this table unless you really know 
what you are doing). ClassWizard in¬ 
serts lines that represent methods 
and properties into the table. Each 
line is implemented by one of the 
MFC 2.5 macros that define methods 
and properties for your automation 
interface. Some macros define meth¬ 
ods and properties using names, oth¬ 
ers take IDs, and others specify pa¬ 
rameters. 

AppWizard also adds this line to 
the document class constructor: 

EnableAutomationO; 


Defined in the CCmdTarget class, En¬ 
ableAutomationO enables OLE 2 auto¬ 
mation for an object. Once an object 
is automation-enabled, an IDispatch 
interface is created for the object, 
which means that a client application 
can now get the IDispatch interface 
pointer. 

AppWizard also adds this line to 
the document class constructor: 

AfxOleLockAppO; 

The MFC framework keeps track of 
the number of active objects the ap¬ 
plication has created. An active ob¬ 
ject is any object whose reference 
count is non-zero. Any class that ex¬ 
poses OLE interfaces should call 
AfxOleLockAppO, a global MFC func¬ 
tion that increments the active object 
count. This prevents a class instance 
(object) from being destroyed while 
still being used by a client. If a user 
tries to close a server while the serv¬ 
er is being used by a client, the MFC 
framework hides the server until the 


active object count reaches zero. Once the count reaches 
zero, the MFC framework can safely terminate the server. 

Global object count is very important for automation. 
Imagine that you have launched an automation server ap¬ 
plication. You then launch an automation client applica¬ 
tion. The client gets the server's automation interface 
pointer and they start interacting. Next, you decide that 
you are done with the server and terminate the applica¬ 
tion with File/Exit. If the server just unloads itself, the cli¬ 
ent is left hanging, since it still has an automation inter¬ 
face pointer to the server. To avoid this problem, the serv¬ 
er application is hidden but remains loaded with its auto¬ 
mation interface intact. The client can still call the server's 
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-lint 


for C/C++ 

presents Bug # 653 


#include <stdlib.h> 


double r() 


t 


return (double) (rand() 

/ RAND MAX); 

> 


int main() 


t 


int i; 


for( i = 0; i < 10; i++ 

> 

printf( "%g\n", r() 

>; 

return 0; 


} 



The programmer wants r () to return a random number between 0 and 1 using 
the ANSI random number facility. But the numbers appear decidedly less than 
random. What’s going on? Call if you need a hint. Refer to Bug #653. 
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and templates. It supports both Borland and 
Microsoft C/C++. 
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methods and properties. When the client is finished with 
the server, it calls Release0 to free the object. At this 
point, all objects in the server are released and the server 
application is unloaded. 


AppWizard also adds this line to the document class 
destructor: 

AfxOleUnlockAppO; 


Listing 7 autosdoc.cpp — AutoEditor’s document class implementation file 


// autosdoc.cpp : implementation of the CAutoservDoc class 

#include "stdafx.h" 

♦include "autoserv.h" 

♦include "autosdoc.h" 

♦include "autosvw.h" 

♦ifdef .DEBUG 
♦undef THISJILE 

static char BASED.CODE THIS_FILE[] =_FILE_; 

♦endif 

///////////////////////////////////////////////////////////////////////////// 
// CAutoservDoc 


VTSJSTR) 

DISP_FUNCTION(CAutoservDoc, 
DISP_FUNCTION(CAutoservDoc, 
DISPJUNCTION (CAutoservDoc. 
DISPJUNCTION (CAutoservDoc. 
DISPJUNCTION (CAutoservDoc, 
DISPJUNCTION (CAutoservDoc, 
DISPJUNCTI ON (CAutoservDoc, 
DISPJUNCTION (CAutoservDoc. 
DISPJUNCTION (CAutoservDoc. 


"FileCloseDoc". FileCloseDoc, VTJOOL, VTSJONE) 
"EditUndo", EditUndo, VTJOOL. VTSJONE) 
"EditCut". EditCut. VTJOOL. VTSJONE) 
"EditCopy", EditCopy. VTJOOL. VTSJONE) 
"EditPaste", EditPaste. VTJOOL. VTSJONE) 
"EditFind", EditFind. VTJOOL. VTSJSTR) 
"EditFindNext". EditFindNext. VTJOOL. VTSJONE) 
"EditGetText", EditGetText, VTJSTR. VTSJONE) 
"EditSetText", EditSetText. VTJOOL. VTSJSTR) 


DISP_FUNCTION(CAutoservDoc, "EditGetSelectedText", EditGetSelectedText. 

VTJSTR. VTSJONE) 

//)}AFX_DIS PATCH_MAP 
END_DIS PATCH_MAP() 


IMPLEMENTJYNCREATE(CAutoservDoc. CDocument) 

BEGIN JESSAGE JAP (CAutoservDoc. CDocument) 

//{{AFXJSG_MAP(CAutoservDoc) 

// NOTE - the ClassWizard will add and remove mapping macros here. 
// DO NOT EDIT what you see in these blocks of generated code! 
//)}AFX_MSG_MAP 
ENDJESSAGEJAPO 

BEGINJISPATCH_MAP(CAutoservDoc. CDocument) 

// {{AFXJISPATCH.MAP (CAutoservDoc) 

DISPJUNCTION (CAutoservDoc. "FileNewDoc", FileNewDoc. VTJOOL. VTSJONE) 
DISPJUNCTION (CAutoservDoc. "FileOpenDoc". FileOpenDoc. VTJOOL. VTSJSTR) 
DISPJUNCTION (CAutoservDoc. "FileSaveDoc", FileSaveDoc. VTJOOL. VTSJONE) 
DISPJUNCTION (CAutoservDoc, "FileSaveDocAs". FileSaveDocAs. VTJOOL, 


1 
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///////////////////////////////////////////////////////////////////////////// 
// CAutoservDoc construction/destruction 

CAutoservDoc::CAutoservDoc() 

( 

EnableAutomationO; 
m_strSearchText.Empty(); 

AfxOleLockAppO; 

} 

CAutoservDoc::~CAutoservDoc() 

{ 

AfxOleUnlockAppO; 

) 

BOOL CAutoservDoc::OnNewDocument() 

{ 

if (!CDocument::OnNewDocument()) 
return FALSE; 

CEdltView* pView = (CEditView*)m_viewList.GetHead(); 
ASSERT(pView->IsKindOf(RUNTIME_CLASS(CEditV1ew))); 
pView->GetEditCtrl().SetWindowText( "" ); 
pView->Inval1date(); 

return TRUE; 

} 

///////////////////////////////////////////////////////////////////////////// 
// CAutoservDoc serialization 

void CAutoservDoc::Serialize(CArchive& ar) 

{ 

CEditView* pView = (CEditView*)m_viewList.GetHead(); 

ASSERT(pView->IsKindOf(RUNTIME_CLASS(CEditView))); 
pView->SerializeRaw(ar); 

} 

///////////////////////////////////////////////////////////////////////////// 
// CAutoservDoc diagnostics 

♦ifdef JEBUG 

void CAutoservDoc::AssertVal1d() const 
{ 

CDocument::AssertVal1d(); 

} 

void CAutoservDoc::Dump(CDumpContext& dc) const 
{ 

CDocument::Dump(dc); 

} 

♦endif //JEBUG 

///////////////////////////////////////////////////////////////////////////// 
// CAutoservDoc commands 

BOOL CAutoservDoc::FileNewDoc0 

{ 

CAutoservApp * pApp = (CAutoservApp *)AfxGetApp(); 
pApp->m_pMainWnd->PostMessage( WM.COMMAND, ID FILEJEW. 0L ); 
return( TRUE ); 

} 

BOOL CAutoservDoc::Fi1eOpenDoc(LPCSTR pDocName) 

{ 
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AfxOleUnlockApp is called to decrement the count. In the ex¬ 
ample above, the client calls ReleaseO to free the auto¬ 
mation interface object. Destroying the class instance calls 
AfxOleUnlockAppO. Now the global object count is 0 and 
the application can be unloaded. 


Listing 7 continued 


CAutoservApp * pApp = (CAutoservApp *)AfxGetApp(); 
return( pApp->0penDocumentF11e( pDocName ) != HULL ); 

} 

BOOL CAutoservDoc::FileSaveDoc() 

{ 

return( DoSave( m_strPathName )); 

} 

BOOL CAutoservDoc::Fi1eSaveDocAs(LPCSTR pNewDocName) 

{ 

CString str( pNewDocName ); 
return( DoSaveC str )); 

} 

BOOL CAutoservDoc::FiledoseDoc() 

{ 

OnFIleCloseO; 
return( TRUE ); 

} 

BOOL CAutoservDoc::EdltUndoC) 

{ 

CEditView* pView = (CEditView*)m_v1ewList.GetHead(): 
ASSERT(pV1ew->IsKind0f(RUNTIME_CLASS(CEditView))); 

BOOL bResult = FALSE; 

if ( pView->6etEditCtrl().CanUndo() ) 

bResult = pV1ew->GetEditCtrl().Undo(); 

return( bResult ); 

} 

BOOL CAutoservDoc::EditCut() 

{ 

CEditView* pView « (CEditV1ew*)iB_viewL1st.GetHead(); 
ASSERT(pView->IsK1nd0f(RUNTIME_CLASS(CEd1tView))); 
pVIew->GetEd1tCtrl().Cut(); 
return TRUE; 

} 

BOOL CAutoservDoc::EditCopy() 

{ 

CEditView* pView = (CEdltVIew*)m_viewList.GetHeadC): 
ASSERT(pV1ew->IslCindOf(RUNTIME_CLASS(CEditView))); 
pVIew->GetEditCtrl().Copy(); 
return TRUE; 

} 

BOOL CAutoservDoc::Ed1tPaste() 

{ 

CEditView* pView * (CEditView*)m_v1ewList.GetHead(); 
ASSERT(pView->IsK1nd0f(RUNTIME_CLASS(CEditView))); 
pVIew->GetEditCtrl().Paste(); 
return TRUE; 

} 

BOOL CAutoservDoc::EdltFInd(LPCSTR pSearchText) 

{ 

CEditView* pView = (CEd1tV1ew*)m_viewList.GetHead(); 
ASSERT(pV1ew->IsK1nd0f(RUNTIME_CLASS(CEditView))); 

BOOL bResult = pView->FindText( pSearchText ); 
m_strSearchText = pSearchText; 
return( bResult ); 

} 

BOOL CAutoservDoc::EdltFIndNextC) 

{ 

CAutoservView * pView = (CAutoservView *)m_viewList.GetHeadC); 
ASSERT(pV1ew->IsKind0f(RUNTIME_CLASS(CAutoservView))); 
return( pV1ew->F1ndNext( m_strSearchText ) ); 

} 

BSTR CAutoservDoc::EditGetTextC) 

{ 

CString s; 

CEditView* pView = (CEditView*)m_viewList.GetHeadO; 
ASSERT(pV1ew->IsK1nd0f(RUNTIME_CLASS(CEditView))); 
pV1ew->GetEditCtrl().GetW1ndowText( s ); 
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Adding Methods and Properties 

There are two ways to add methods and properties to 
your automation server. The easy way is to use Visual 
C++ 1.5, MFC 2.5, and CiassWizard. The painful way is to 
do it manually. 

To add methods and properties with CiassWizard, run 
CiassWizard. From the Class Name list, choose the class 
that contains your methods and properties. Click the 'OLE 
Automation' button to bring up the dialog where you add 
methods and properties. Next, click either the Add Method 


Listing 7 continued 


return s.AllocSysStringO; 

} 

BOOL CAutoservDoc::EditSetText(LPCSTR pText) 

{ 

CEditView* pView = (CEditView*)ui_viewList.GetHead(); 
ASSERT(pView->IsKindOf(RUNTIME_CLASS(CEditView))): 
pView->GetEditCtrl().SetWindowText( pText ); 
pView->Invali dated; 
return TRUE; 

} 

BSTR CAutoservDoc::EditGetSelectedText() 

{ 

CString s; 

CEditView* pView = (CEditView*)m_viewList.GetHead(); 
ASSERT(pView->IsKindOf(RUNTIME_CLASS(CEditView))); 
pView->GetSelectedText( s ); 
return s.AllocSysStringO; 

} 

// End of File 
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or Add Property button. Both of these buttons bring up a 
dialog where you specify the external name, internal 
name, variable names and types, return types, etc. Finally, 
press the Edit Code button. CiassWizard brings up the win¬ 
dow that contains the source code for the methods and 
properties you just added. The skeleton for each method 
and property is coded. You now need to add the specifics. 
Figure 1 contains a screen shot of the CiassWizard dialog 
after the date and time methods were added to 
CDateTimeAuto class. 

Here are the lines that CiassWizard generated when I 
added the EditCopy method: 

// .h file 

afxjnsg BOOL EditCopyO; 

// .cpp file 

// in the dispatch table. 

DISP_FUNCTION(CAutoservDoc, "EditCopy", EditCopy, 
VTJOOL, VTSJONE) 

// skeleton code. 

BOOL CAutoservDoc::EditCopy() 

{ 

// TODO: Add your dispatch handler code here 
return TRUE; 

} 

To add methods and properties manually, you need to do 
what CiassWizard would do for you. That is, after defining 
your method or property, add the appropriate function 
prototype to your class header file. Next, add the macro 
that properly defines your type of method or property to 
the dispatch table in your .cpp file. Finally, implement your 
method or property. Managing the dispatch table is the 
toughest part. You need to figure out which macro to use. 
You also need to map your arguments and return values 
to the proper VT_ and VTS_ values so that IDispatch knows 
what kind of arguments and return values to expect. 

Building of AutoEditor 

As explained earlier, automation is usually imple¬ 
mented in the document class. AutoEditor is no different. I 
will briefly cover the lines I added to the CAutoservDoc class 
after AppWizard generated the skeleton. First, the header 
file autosdoc.h (Listing 6): 

// Implementation 
private; 

CString mjtrSearchText; 

I needed a place to save the search string so that I 
could do the 'Find Next' operation. This is where it is 
saved. The class CString is an MFC class that handles 
string manipulation. 

Remember the earlier talk about dispatch tables? autos¬ 
doc.h (Listing 6) also shows the dispatch map table which 
contains the function prototypes for AutoEditor's methods 
and properties. As you can see, there are some magical 
strings within comments that allow CiassWizard to find the 
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dispatch table within your header file. Wrapped around 
some more MFC magic macros are the prototypes for the 
functions that represent the methods and properties for 
AutoEditor. 

autosdoc.cpp (Listing 7) contains the dispatch table defi¬ 
nition. As you may have noticed, it is wrapped by some 
more MFC magic macros. Flowever, the gist of BEGIN_DIS- 
PATCHJAPO and END_DISPATCH_MAP() is of course the start 
and end of an OLE 2 automation dispatch table. The com¬ 
mented lines between BEGIN_DISPATCH_MAP() and EHDJIS- 
PATCH_MAP() allow ClassWizard to find the dispatch table in 
your .cpp file. 

The macro DISP_FUNCTION() defines an OLE 2 automat¬ 
ion method. As an example, let's look at this line: 

DISP_FUNCTION(CAutoservDoc, "EditSetText", EditSetText, 
VTB00L, VTSJSTR) 

This macro takes five arguments: 

• CAutoservDoc - class name that implements this 
method. 

• “EditSetText” - external name of method. 

• EditSetText - implementation class member function. 

• VT_B00L - return type. Here I return a Boolean value. 

• VTSJSTR - space-separated list of argument types. Here 
I take an argument that is a string. 

The only task left is to implement the methods, autos¬ 
doc.cpp (Listing 7) implements each method, starting with 
member function FileNewDocO, which creates a new docu¬ 
ment. 

Conclusion 

To be a successful and marketable developer, you must 
stay tuned to the latest trends. Well, OLE 2 is here and 
gaining momentum, i think OLE 2 automation will prove 
to be one of the most frequently used capabilities of OLE 
2, because it answers the long held question, "What about 
a scripting language for Windows?" With automation, you 
create your own methods and properties specific to your 
application and let OLE 2 do the rest. 

Also, as you've probably figured out, MFC 2.5 is the 
only way to create OLE 2 applications, at least for any 
project with a tight schedule. MFC 2.5 and its 60Kb of OLE 
2 source code can save you three to six months of devel¬ 
opment and testing. 

Learn OLE 2 and automation; it can be fun! For exam¬ 
ple, I recently added demonstration code to an object I've 
been working on. This object interacts with an automation 
server. My demonstration code generates a diagram on 
the fly with the aid of the automation server application. 
My object knows nothing of graphics, drawings, or dia¬ 
grams - but with the help of the other application and 
OLE 2 automation, it can generate a data flow diagram 
that represents its own processing and serves as a nice 
marketing and demonstration tool. □ 
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More Undocumented 
Macros 


Jim Mischel 


My earlier article, 'Undocumented WinHelp Macros,' which appeared in the 
January 1994 issue of Windows/DOS Developer's Journal, revealed a number of 
useful but undocumented macros and identifiers that exist in the Windows 3.1 
version of WinHelp. In that article, I solicited information from readers, and 
many of you responded. With your input, and some further experimentation, 
I've discovered some further information about some of those macros, and a 
few other tricks that might come in handy. 

CommandO Revealed 

In the January article, I mentioned that I was unable to determine the use of 
the ComidndO and GenerateO macros. Shortly after the magazine was published, 
I got a letter from Tom Gibson, a reader in Houston, TX. Tom writes: 
os-" C '° 5 i0 g'~- a^- 1 J ust read y° ur artlc,e on undocumented WinHelp macros. It's nice to see that I'm 

, r.\ ql: - ^oc'O s '^oc'g J . not the only one who has ever heard of these. Microsoft support people have been no 

‘ ^ - ^oc'° s hel P ln t0 c,eci P her tfie macros. The ones that stumped me also seem to have 

' ( 'os;^oc'^ s .%c^'° s s .^og°|- gj ven y 0U some problems; however, after reading the article, I sat down and cracked 

one of them. The CommandO macro activates a menu command from WinHelp. The 






macro takes as a parameter the WM_COMMAND number. 

Tom then lists the command values, which I've duplicated in Table 1. I'm 
not sure how Tom discovered this (I always like to see people's methods, hop¬ 
ing that I can duplicate them in the future), but the information certainly is 
useful. Further experimentation revealed that items added to menus are as¬ 
signed numbers, starting with 10004, in the order in which they are added. So, 
if you were to add five items to WinHelp menus (either to the standard menus, 
the floating menu, or new menus), those items would be assigned numbers 
10004, 10005, 10006, 10007, and 10008, in the order in which you add them. 
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Jim Mischel is a programmer for Ability Software in Tempe, AZ, and moonlights as an 
independent programmer and technical writer. He is the author of The Developer's 
Guide to Windows Help, published by John Wiley 9 Sons. Jim can be reached on 
CompuServe at 75300,2525. 
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RPC for NT shows you how to write a 
distributed application using the Remote 
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Using Microsoft’s RPC implementation, an 
NT server and clients running MS-DOS, 
Windows 3.1, Windows for Workgroups, or 
Windows NT can work together to solve a 
complex problem in a fraction of the time it 
would have taken a single machine. 


Build Remote Procedure Calls 
from basic to sophisticated 

Guy Eddon guides you from a simple "Hello 
World" RPC application through a series of 
increasingly demanding programs that 
encompass all aspects of remote procedure calls. 
You’ll learn about: 

■ Implicit and explicit binding procedures 

■ Structured exception handling 

■ Multithreaded servers 

■ The RPC name service 
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It's not clear to me why this 
macro even exists. All of the stand¬ 
ard WinHeip menu commands have 
corresponding macros, and Com- 
mand(lWl) doesn't seem any easier to 
write than FileOpenO. The only rea¬ 
sonable explanation that I can come 
up is that CowmandO makes it possible 
for your help files to execute custom 
menu commands that you've added. 
Without Commando, you'd have to cre¬ 
ate a custom macro to activate your 
menu commands. 

GenerateO Demystified 

Shortly after my book was pub¬ 
lished, I mentioned on the Com¬ 
puServe WINSDK forum that I still 
hadn't figured out what the Gener¬ 
ateO macro does. I got a number of 
responses to that query, the first 
from John Bradnam. John writes: 

Command(u) just invokes the Gener¬ 
ate (uUU) macro. 

The first parameter in the GenerateO 
macro is set to WM_COMMAND, i.e. lllh. The 
second is the u parameter from the Com¬ 
mando macro converted to a long. The 
third parameter is always 0. 
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So, Command(u) is just a special case for the macro Generated 
which posts or sends a message to the main help window. The 
message is sent if it is greater than WMJJSER+100 (464hj. Other¬ 
wise, it is posted. So GenerateO is just Generate(wMsg, dParaml, 
dParam2) and equates to: 

procedure GenerateCwMsg:THandle;dparaml:1ongint;dPa ram2:1ongint); 
begin 

if wMsg > WMJJSER+100 then 
SendMessage(hHelpWnd.wMsg.L0W0RD(dParaml),dParam2) 
else 

PostMessage(hHelpWnd,wMsg,L0W0RD(dParaml),dParam2); 

end; 

In other words, GenerateO gives you a way to send Win¬ 
dows messages directly to the help window. You could 
play some interesting games with this macro - I'd be in¬ 
terested in hearing from you if you come up with a good 
use for it. 

More Info on ExtlnsertltemO and 
ExtlnsertMenuO 

As I pointed out in the January article, the Extlnser¬ 
tltemO and ExtlnsertMenuO macros work exactly like their 
documented counterparts, Insert I temO and InsertMenuO, 
except that the Ext... versions accept one more parame¬ 
ter, which I called enabled-state. In my article, I said that 
the enabled-state parameter should be 0 to enable the 


menu or item, or 1 to disable it. That's true as far as it 
goes, but I learned of a number of other values for this 
parameter from another reader, Paul A. O'Rear, with 
whom I traded a number of CompuServe messages. Paul 
writes: 

The last parameter to the ExtlnsertltemO and Extlnsert- 
Menu( ) undocumented macros is more broad than you imply in 
your docs and help file. Initially, I thought that it was limited to 
three possibilities: 

0x0000 

MF_ENABLED 

0x0001 

MF_GRAYED 

0x0002 

MF_DISABLED 

The third possibility at least is missing from your docs. It pro¬ 
vides a normal-looking, but nonfunctional menu item. After I 
played around with them all day though, I found out that you 
can use almost all of the MF_ identifier values to accomplish 
more wonderful things. For instance: 

0x0008 
MF_CHECKED 
Checks the item 
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0x0020 

MFJOUBARBREAK 
Creates a two column menu 

0x0040 

MF_MENUBREAK 

Creates a two column menu without a 
vertical bar 


0x0080 
MF_HILITE 

Highlights the inserted item, 
but does not give it the focus 


0x0800 

MF.SEPARATOR 

Inserts a menu separator 


Table 1 Command-number 
values for the CommandQ macro 


Menu Item 
Command Number 

File|Open 

1101 

File|Print Topic 

1103 

File|Print Setup 

1104 

FiIe|Exit 

1105 

Edit|Copy 

1203 

Edit|Annotate 

1202 

Bookmarkpefine 

1301 

Bookmark|More 

1302 

Help|How to Use Help 
10003 

Help|Always on Top 
10002 

Help|About 

1503 

Defined Bookmarks 
1303, 1304, etc. 

Custom menu items 
10004, 10005, etc. 


Table 2 Enabled-state 
parameters for ExtlnsertltemQ and 
ExtlnsertMenuQ 


Value 

MFjcxx 

Constant Description 

0x0000 

MF_ENABLED 

Creates an enabled menu item 

0x0001 

MF_GRAYED 

Creates a grayed menu item 

0x0002 

MF_DISABLED 

Creates a disabled menu item 

0x0004 

MF_BITMAP 

Not useable in WinHelp 

0x0008 

MF_CHECKED 

Creates a checked menu item 
0x0020 

MF_MENUBARBREAK 
Creates a two-column menu 

0x0040 

MFJVIENUBREAK 
Creates a two-column menu 
without a vertical bar 

0x0080 

MF_HILITE 

Creates a highlighted menu item 
0x0100 

MFJDWNERDRAW 
Not useable in WinHelp 

0x0200 

MFJJSECHECKBITMAPS 
Not useable in WinHelp 

0x0400 

MF_SEPARATOR 
Creates a menu separator 

0x1000 
MF_REMOVE 

No visible effect in WinHelp 

0x2000 

MF_SYSMENU 

No visible effect in WinHelp 

0x4000 

MF_HELP 

No visible effect in WinHelp 
0x8000 

MF_MOUSESELECT 
No visible effect in WinHelp 
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Each of these can be used with each other and the previous 
three: 

0x0029 MF_MENUBARBRAEK | MF_CHECKED | MF_GRAYED 

0x0004 is the MF_BITMAP identifier. When you try to use this it 
seems as if WinHelp actually tries to load a bitmap, but doesn't 
know where to find it If there were a way to pass a pointer to a 
bitmap in the functions, I'm sure it would display it These could 
then also be used in conjunction with the MF_ENABLED, 
MFJOUBAR, MF_CHECKED, and other values. 

For some reason, ExtAbleltemO only accepts the first three 
parameter values: MF_ENABLED, MF_GRAYED, and MF_DISABLED. It 
ignores all other values. 

Paul then provides a table of identifiers and combina¬ 
tions that is quite useful if you want to experiment with 
adding menus and menu items. This information is repro¬ 
duced in Table 2. 

The SeqTopicKeys WIN.INI Variable 

In my book, I mentioned all of the WinHelp win. ini 
variables that I knew of at the time. Shortly thereafter, I 
found a reference to SeqTopicKeys and discovered its use. 
In the [Windows Help J section of win. ini, setting SeqTopicKeys 
to 1 allows you to single-step through all of the topics in a 
Windows Help file (including popups). Pressing 
Ctrl+Shift+Right Arrow moves to the next topic, and 
Ctrl+Shift+Home moves to the first topic in the help file. 


Ctrl+Shift+Left Arrow doesn't do anything, but you can 
move backwards through the topics that you've viewed 
by pressing the WinHelp Back button. 

There is an annoying bug with SeqTopicKeys. Pressing 
Ctrl+Shift+Right Arrow on the last topic results in a 'Help 
topic does not exist' error message from WinHelp. This 
message will be displayed twice. I don't know of any way 
around this error. 

Undocumented Macros and Windows 4.0 

According to information posted by Microsoft on sec¬ 
tion 16 of the WINSDK forum on CompuServe, Winhelp 
4.0 will support all of the macros and identifiers that were 
supported by Winhelp 3.1 - including the undocumented 
macros and identifiers that I and others have discovered. I 
also understand that all of these previously undocu¬ 
mented features (and any new features) will now be fully 
documented, which will make my job as a help developer 
much easier, but will rob me of article opportunities. 

Your Turn, Again 

As before, I solicit your input. With an application as 
complex as WinHelp, it's unlikely that we've discovered 
everything that it can do. If you or somebody you know 
has discovered an undocumented feature, please leave 
me a message on CompuServe, or contact me through the 
magazine. □ 
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Windows NT File System 
Developers Conference Report 


Paula Tomlinson 


Who would have thought that Microsoft would have to turn away develop¬ 
ers wanting to attend a three-day conference devoted exclusively to Windows 
NT File System Drivers? Nearly 200 developers met in Seattle on October 18-20 
to attend the Windows NT File System Developers Conference. Microsoft was 
reportedly still turning away developers the day before the conference started. 
The reason for this enthusiasm is clear when you consider that detailed specifi¬ 
cations for Windows NT file system drivers have never before been available in 
any form to developers. In fact, Microsoft speakers confessed that they are 
only now just beginning to fully document, internally, the APIs relating to file 
systems. 
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What is an installable file system driver anyway? The 
Windows NT operating system supports the notion of in¬ 
stalling different file systems without having to rebuild the 
operating system or even reinstall the operating system. 
In fact, even if you don't have an HPFS (High Performance 
File System) or NTFS (NT File System) volume on your hard 
disk, you are probably still using several different file sys¬ 
tems when you run Windows NT. Currently, the FAT file 
system is the only file system supported for floppy drivers, 
and when you access a CD-ROM under Windows NT, you 
are using the CDFS file system. There are also file systems 


for named pipes (NPFS), mailslots (MSFS), the LAN Manager 
Redirector (RDR) and the Netware redirector (CSNW). Tech¬ 
nically, there is also a simple little file system called RAW 
that exists to claim volumes not recognized by other file 
systems. With all of these available, could there possibly 
be a need for more file systems running on Windows NT? 
At the beginning of the conference, a show of hands indi¬ 
cated that only a handful of developers were actually 
planning on writing their own on-disk file system drivers. 
Of the rest, about half were interested in filter drivers and 
the other half were interested in networking file systems 
and redirectors. 

File system drivers essentially fol¬ 
low the same rules as any other ker¬ 
nel-mode device driver, so the Win¬ 
dows NT DDK include files, libraries, 
and documentation are required for 
writing a file system driver. But file 
system drivers also have a host of 
special interfaces to support and fea¬ 
tures to provide. All of these issues 
were addressed at the first-ever Win¬ 
dows NT File System Developers Con¬ 
ference. 

What makes a file system driver 
so hard to write? Among other 
things, file system drivers for Win¬ 
dows NT must be portable to differ¬ 
ent processors and safe to run on 
multiple processors. File system driv¬ 
ers must support the security built 
into Windows NT as well as some of 
the new file I/O features of Windows 
NT, such as locking ranges of a file 
and providing directory change notifi¬ 
cations. Not to mention that the pag¬ 
ing file Windows NT uses to support 
its virtual memory management 
might be located on a volume that 
your file system driver is supporting 
- or the issues of maintaining coher¬ 
ent files across networks. All this 
means that file system drivers have 
very complex and crucial interactions 
with several subsystems of the Win¬ 
dows NT Executive; namely the 
memory manager, the cache man¬ 
ager, the security subsystem, and the 
I/O subsystem (of which file system 
drivers are a part). 

By far the most complex issue dis¬ 
cussed at the conference is prevent¬ 
ing deadlock situations within the file 
system. On preemptive multitasking 
operating systems, a deadlock occurs 
when two threads are each waiting 
for objects that the other thread has 
acquired. In such a case, the two 
threads wait forever, typically causing 
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the system to crash. But one thread isn't supposed to 
crash Windows NT, you say? Well, welcome to kernel 
mode. In Windows NT, kernel-mode code is considered 
privileged and trusted code. Consequently, much less error 
checking and parameter validation is performed when ap¬ 
plication code interacts with kernel-mode operating sys¬ 
tem components or kernel-mode device drivers. More 
than one developer was shaken by Robert Reichei's frank 
and detailed description of spending months of intensive 
testing to root out the last few deadlock bugs in the NTFS 
driver. 


contains a compiler and linker for the x86 and MIPS proc¬ 
essors, so device driver developers will also need Version 
2.0 of the 32-bit edition of Visual C++. 

Did the conference meet our needs? 

In my opinion, the Windows NT device driver confer¬ 
ences are the best conferences that Microsoft holds, and 
this conference didn't change that opinion. Perhaps it was 
the proximity to Redmond that allowed them to bring in 
speakers like Lou Perazzoli for just one hour to discuss the 


Conference Materials 

Each conference attendee received 
a preliminary Installable File System 
(IFS) Developers Kit, the new version 
2.0 of the 32-bit edition of Visual 
C++, and a copy of Flelen Custer's 
new book, Inside the Windows NT File 
System. The IFS kit currently consists 
only of a preliminary version of the 
Windows NT Installable File Systems Ref¬ 
erence manual and a floppy disk. The 
floppy contains a few online refer¬ 
ences for network file system topics, 
the #include files necessary for build¬ 
ing a file system driver, and the com¬ 
plete source code for the CDFS and 
RAW file systems native to Windows 
NT. The reference manual contains a 
list of the NT file services and run¬ 
time library routines (generally a su¬ 
perset of those used by other kernel¬ 
mode device drivers) that are of par¬ 
ticular importance to IFS driver writ¬ 
ers. It also lists salient data structures 
used by IFS drivers. There are still 
some important gaps in the reference 
material, however. For example, the 
cache manager API routines are ex- 
trememly important for IFS drivers 
but are not yet documented in the 
reference manual. The IFS will be 
supported by a peer CompuServe fo¬ 
rum, probably part of the MSWIN32 
forum and by other (paid) support 
programs. 

It's not clear how anyone who did 
not attend the conference could re¬ 
ceive this information at this point or 
in the near future. The IFS kit is in¬ 
tended to be a supplement to the 
regular Windows NT Device Driver 
Kit and will eventually be distributed 
as part of it. For the time being, 
those who do have the IFS kit will 
need to also have the Windows NT 
SDK and DDK. In fact, the 3.5 release 
of the Windows NT SDK no longer 
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memory manager. The speakers were all very effective 
and were the architects, the true experts, of the topics 
they were discussing. The other speakers were Darryl Ha¬ 
vens, Gary Kimura, Brian Andrew, Jim Kelly, Robert 
Reichel, David Gobel, Chuck Chan, Joe Linn, and Dave 
Beaver. 

For the handful of developers actually writing a file sys¬ 
tem driver, the information presented at the conference 
was necessary but probably insufficient. Developers are 
still crying for a design guide manual and more source 


code examples - in particular, an example showing the 
file system write path would be helpful (the CDFS file sys¬ 
tem, of course, only supports reading). A concise list of 
which features and entry points are mandatory and which 
are optional would also go a long way in clearing up con¬ 
fusion. A new release of the IFS kit is promised in about 
six months and each attendee will receive video tapes of 
each conference session within a few weeks of the confer¬ 
ence 

For the large group who plan to write file system filter 
drivers, the information was again 
important and useful. Many filter 
drivers attach to file system drivers, 
and thus need to support any routine 
that the file system driver supports. 
Still, a single session devoted exclu¬ 
sively to issues related to filter drivers 
would have been very useful to at 
least half the audience. 

I think the conference also met 
Microsoft's goal, which was admit¬ 
tedly to scare most developers away 
from writing file system drivers! 
Those developers who can provide 
solutions by other means than a file 
system driver are probably seriously 
considering that, and those who re¬ 
ally must write a file system driver 
have some important information 
that they didn't have before. 

Other NT News 

Conferences are also one of the 
best sources of information about fu¬ 
ture releases of the operating system 
and the development environment. 
Apparently, the next release of Win¬ 
dows NT (Windows NT 3.5, Daytona, 
was released in October) will be cen¬ 
tered on the long-delayed release of 
IBM's PowerPC-based systems. A ver¬ 
sion of Windows NT running on the 
PowerPC will be released at that time 
(perhaps as early as the first quarter 
of '95). This version of Windows NT 
will be released for the x86, MIPS, 
and Alpha as well and will reportedly 
include some type of disk compres¬ 
sion support as well as defect 
fixes. Microsoft doesn't seem to be 
planning to drop support of the 
aging FAT file system from any of 
its operating systems, but it ap¬ 
pears that HPFS support may be 
dropped from Windows NT by the 
Cairo timeframe. □ 


Distinct ■ Visual Edition 

TCP/IP 


TCP/IP Custom Controls for Windows 
Sockets, Telnet, FTP, RCP, R-commands 
(remote shell, rlogin and rexec), Mail 
(SMTP, POP2/POP3) and News (NNTP). 
For Visual Basic users onlv. 



For C, C + +, 
Visual C++, 
Turbo Pascal, 
Visual Basic 
and other 
Windows 
programmers 


Email: mkt 3 @distinct.c 0 m 
Fastfacts: 408.366.2101 
Fax: 408.366.0153 

Phone: 408.366.8933 


dfstinct 


Just define properties and handle events, no 
DLLs to call or TSR to use. 

sample applications and over 200 pages of 
documentation included. 

Includes Distinct’s small and fast Windows 
Sockets protocol stack; extensions run over 
other Windows Sockets compliant stacks. 


Standard 


APIs for Windows Sockets, Berkeley 
Sockets, ONC RPC/XDR, Telnet, FTP, 
SMTP, POP2/POP3, NNTP and NetWin. 

Supports NDIS, ODI or Packet drivers, SLIP. 
CSLIP and PPP with scripting. 

Co-exists with Windows for Workgroups, 
Netware, Lan Manager, Vines, Lantastic and 
Pathworks. 

Over 400 KB source code samples in C, C++, 
and Pascal. 

Small fast and robust 100% DLLs, allow up to 
128 concurrent sessions. 

Includes C++ Class Libraries for Windows 
Sockets, Telnet and FTP. 


Professional 


Includes all the features of the Standard Edition 
PLUS Telnet VT emulator, drag and drop FTP 
client and server, TFTP, LPR, LPD, transparent 
printing. Network Monitor. Finger and more. 
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Edited by 
Leor Zolman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they 
should! You'll receive at least $50 for 
each tip that we print 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
Noth Reading, MA 01864 


Resolution-Independent Window Centering 


Scooper N. Ong 
scooper@extrel.com 

I like my dialog to pop-up at the center of the screen, regardless of the 
screen resolution. During the UM_INITDIALOG, I obtain the size of the dialog, with 
GetUindowRectO, and the size of the current screen resolution, with GetSystemMet- 
ricsO. This allows me to compute for the coordinate to which the dialog can 
be centered. A call to SetUindowPosO passing the coordinate as well as 
SUP_NOSIZE centers the dialog on screen without changing its size. 

Listing 1 ( ctrdig.di illustrates the technique in a simple application. Listings 2 
and 3 are the support files for the application, and Listing 4 is the Borland C 
Make file. 

Note that this technique can also be used for the main window. 

Partition Tables from Hell 


Jean-Francois Larvoire 
Hewlett-Packard 
Iarvoire@hp6300.desk.hp.com 

I read your Tech Tip called 'A Tale Of Two Operating Systems' in the June 
'94 issue of Windows/DOS Developer's Journal. 

We had the same problem here a couple of months ago, and lost two 
weeks trying to solve it. In our case, we even had only a single MS-DOS parti¬ 
tion that spanned the whole disk! We asked Microsoft for support, but they did 
not help us any more than they were able to help you. We had to single-step 
through the whole Windows startup to find out what happened. 




Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and "Tech Tips" 
editor for Windows/DOS Developer's Journal. His book Illustrated C, was publish¬ 
ed in 1992. He may be contacted at 74 Marblehead SL, North Reading, MA 01864. 
Internet address: 1 eo r@bd s oft. com. 



























Here's the explanation. 

Windows bypasses MS-DOS to access the swap file. 
This is the main reason why permanent swap files are 
faster. To do so, Windows must know the physical loca¬ 
tion of the swap file on the hard disk. This is not as 
straightforward as it seems. The correspondence between 


the logical sector numbers and the physical sectors is well- 
documented in DOS 5. However in pre-DOS 4 times, MS- 
DOS partitions were limited to 32 Mb, and numerous third 
parties came up with innovative ways to overcome this 
limitation. All involved some kind of special partitions, 
identified by dummy operating system IDs. And the corre- 


Listing 1 ctrDig.c 


j y ********************************************* *********************** 

// file : ctrdlg.c 
// author : Scooper N Ong 
// date : Sep 7. 1994 

j /******************************************************************** 


#define STRICT 
include <window$.h> 

include "ctrdlg.rch" 

// — definitions . 

jfdefine SZMODULE "CtrDlg" 

^define SZTITLE "Centered Dialog" 

// — prototypes . 

LRESULT CALLBACK .export WndProc (HWND. UIHT, WPARAM. LPARAM); 
BOOL CALLBACK .export CtrDlgProc (HWND. UINT. WPARAM, LPARAM): 
void CenterOialog (HWND hDlg); 

// — declarations . 

HINSTANCE ghlnstance; 

//. 

// . 



VERSION CONTROL 


Distributed Revision 
Tracking System 


Parallel Development 
DRTS is based on a powerful software develop¬ 
ment model which allows individuals and teams to work 
in parallel. Developers concentrate on developing 
software while DRTS tracks every change. Integrating 
multiple sets of changes is efficient and easy. 

To Order, Call: 1 -602-991-82S1 
Visa/MC Accepted 


DOS 

OS/2 


$300 

$300 




WINDOWS « 
UNIX $500 


IKSI 


6325 East Monte Cristo 
Scottsdale, AZ 85254 


Controlled Development 

DRTS is a flexible system which 
adapts to your development 
process, As you develop, 
integrate, test, and 
release, DRTS tracks every 
change at every stage. 
Maintaining multiple 
concurrent releases is 
possible because DRTS 
allows you to easily 
propagate changes 
from one release to 
the next. 


Distributed Development 

DRTS provides seamless 
Integration across 
diverse computing 
environments 
including servers, 
workstations, and 
laptop computers 
running Windows, 
DOS, OS/2 and 
UNIX. Whether your 
development occurs 
on a LAN or between 
multiple sites, DRTS tracks 
changes where they 
are made. 
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#pragma argsused 
int PASCAL WinMain ( 

HINSTANCE hlnstance, HINSTANCE hPrevInstance. 
LPSTR lpCmdLine, int nCmdShow) 

{ 

HWND hWnd; 

MSG msg; 

if ( ! hPrevInstance) 

{ 

WNDCLASS wc: 


ghlnstance * hlnstance; 


wc.style 

wc.lpfnWndProc 

wc.cbClsExtra 

wc.cbWndExtra 

wc.hlnstance 

wc.hlcon 

wc.hCursor 

wc.hbrBackground 

wc.lpszMenuName 

wc.1pszClassName 


= CS.HREDRAW I CS_VREDRAW: 

* WndProc: 

= 0 ; 

= 0 ; 

= hlnstance; 

= Loadlcon (NULL, IDI.APPLICATION); 
= LoadCursor (NULL. IDC.ARROW): 

= GetStockObject (WHITE.BRUSH); 

= SZMODULE: 

= SZMODULE: 


if ( ! RegisterClass (Awe)) 
return 0; 

} 


hWnd « CreateWindow ( 

SZMODULE, SZTITLE. 
WS.OVERLAPPEDWINDOW, 
CWJSEDEFAULT, CWJSEDEFAULT, 
CWJJSEDEFAULT, CWJSEDEFAULT. 
NULL, NULL, hlnstance. NULL): 

ShowWindow (hWnd, nCmdShow); 

UpdateWindow (hWnd); 

while (GetMessage (imsg, NULL, 0, 0)) 

( 

TranslateMessage (imsg): 
DispatchMessage (imsg); 

) 

return msg.wParam; 

) 


//. 

//. 

LRESULT CALLBACK .export WndProc ( 

HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM IParam) 

( 

switch (wMsg) 
f 

case WM.COMMAND : 
switch (wParam) 

{ 

case IDM_FILEEXIT : 

SendMessage (hWnd, WM.CLOSE, 0. 0L); 
return 0L: 

case IDM_FILEDIALOG : 

( 

DLGPROC 1pfnDl gProc; 

1pfnDlgProc * (DLGPROC)MakeProcInstance ( 

(FARPROC)CtrDlgProc. ghlnstance); 

DialogBox (ghlnstance, SZMODULE"Popup", hWnd, 1pfnDlgProc): 
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spondence between logical and physical sectors was not 
always the one now expected by MS-DOS. I think Mi¬ 
crosoft wanted to play it safe and make sure that Win¬ 
dows would not break anything should the user install it 
on an old disk partitioned in an exotic way. So they came 
up with a list of incompatible IDs. Unfortunately, there 


was (and there is still) no ID standard. So somebody must 
have used, five or ten years ago, a partitioning scheme 
with the same ID as your UNIX. Also unfortunately, Mi¬ 
crosoft still remembers. The list of forbidden IDs is: 

(text continued on page 46) 



FreeProcInstance ((FARPROCllpfnOlgProc): 
return 0L; 

) 

default : 
break; 

} 

break; 

case WM.DESTROY : 

PostQuitMessage (0); 
return 0L; 

default : 
break; 

} 

return DefklindowProc (hklnd. wMsg. wParam, lParam); 

} 


//. 

//. 

#pragma argsused 


BOOL CALLBACK .export CtrDlgProc ( 

HWND hDlg. UINT uMsg. WPARAM wParam, LPARAM lParam) 

{ 

switch (uMsg) 

{ 

case WMJNITDIALOG : 

CenterDialog (hDlg); 
return TRUE; 

case WM.COMMAND ; 
if (wParam ** 1D0K) 

( 

EndDialog (hDlg, 1); 
return TRUE; 

} 

) 

return FALSE: 

} 


// . 

// . 

void CenterDialog (HWND hWnd) 


SftTabs 1.0 
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LZ..M°'g II 
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Develop tabbed dialogs for 
Windows using C, C++, PASCAL 


OK 
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(201) 366-9618 


Wharton, NJ 07885 

FAX: (201) 366-3984 



Help Perfect turns your WordPerfect documents 
into great Windows Help files 

Continue writing your WP documents using your 
preferred styles and layouts 

Automate the entire Windows Help authoring process 


Create printed matter and on-line Help from a single 
document 


for HELP WITHOUT HASSLE 
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In North and South America 

European Software Connection 
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Elsewhere: 
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27, 23, 24, 26, 31, 33, 34, 36, 45, 50, 57, 56, 67, 
63, 64, 66, 77, 73, 74, 76, AT, A3, A4, A6, 67, B3, 
B4, B6, El, E3, E4, E6, FI, F3, F4, F6. 


Listing 1 continued 

■ ■ -7 

POINT ptScreen; 

POINT ptWindow: 

POINT ptCenter; 

RECT rcWnd: 


// get width and height of dialog 

GetWindowRect (hWnd, ircWnd); 
ptWindow.x = rcWnd.right - rcWnd.left; 
ptWindow.y * rcWnd.bottom - rcWnd.top; 


// get width and height of screen 
ptScreen.x « GetSystemMetrics (SM_CXSCREEN); 
ptScreen.y = GetSystemMetrics (SM_CYSCREEN); 


// compute coordinate to center dialog 
ptCenter.x = (ptScreen.x - ptWindow.x) / 2; 
ptCenter.y * (ptScreen.y - ptWindow.y) / 2; 


// reposition window 

SetWindowPos ( 
hWnd. NULL. 

ptCenter.x. ptCenter.y, // reposition to 

NOLL, NULL. // do not resize 

SWP NOSIZE | SWP NOZORDER); 

} 


/* End of File */ 



Relational Database Classes 

RC/21 

• Multi-Platform 

• Client/Server or Embedded 

• Built-in Relational Engine 

• FAST Development 

• FAST Execution 

• Source Included 

Vermont. 

✓X Database 
Corporation 

1 - 800 - 822-4437 

Vermont Database Corporation Voice: 1 -802-253-4437 
400 Upper Hollow Hill Road Fax: 1 -802-253-4146 

Stowe, VT 05672-4518 vtdatabase@vermont.com 

USA _ CIS: 70334,3705 
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The Windows swap file creation routine first attempts to 
make sure none of these partitions is present on the disk. 
This looks too conservative; checking that none of them is 
the current partition should be enough. The problem is 
that in the worst case, since the contents of the partition 
table are incompatible, the routine won't know how to 
analyze them, and won't know what the current partition 
is. 

In our case, we were working on a new PC, with an 
experimental BIOS that stored some configuration infor¬ 
mation on the boot sector of the hard disk instead of in 
the CMOS. We thought this was clever, until we investi¬ 
gated why Windows persistently refused to create a per¬ 
manent swap file on some of the PCs. The partition table 
is now limited to 4 partitions. But in the past, some sys¬ 
tems had many more. So Windows scans half the boot 
sector for partitions. And it thought our configuration data 
was an incompatible partition. We had to give up the 
idea, and change back to a conventional BIOS. 

How to resolve the problem? 


Listing 2 CtrlDIg.def 

.*********************************************************** 

; file : 

CtrDlg.DEF 

; author 

: Scooper N Ong 

; date : 

Sep 7, 1994 

.*********************************************************** 

NAME 

CtrDlg 

DESCRIPTION 'Centered dialog' 

EXETYPE 

WINDOWS 

STUB 

'WINSTUB.EXE' 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZf 

8096 


Listing 3 CtrDIg.rc 


j[ ******************************************************************** 

// file : CtrDIg.rc 
// author : Scooper N Ong 
// date : Sep 7. 1993 

JJ ******************************************************************** 

^include <windows.h> 

#include "CtrDlg.rch” 

CtrDlg MENU 
BEGIN 

POPUP "JFile” 

BEGIN 

MENUITEM "JDialog ...". I0M_FILEDIALOG 
MENUITEM "Eixit", IDM_FILEEXIT 
END 
END 

CtrDIgPopup DIALOG 19, 30. 95. 53 

STYLE WSJOPUP | WSJISIBLE I WSJAPTION I WS_SYSMENU 

CAPTION "Centered Dialog" 

BEGIN 

CONTROL "This dialog is centered irregardless of screen resolution". 

-1, "static". SS_CENTER I WSJHILD I WSJISIBLE, 7. 6, 80, 26 
CONTROL "&0K", IDOK, "BUTTON". BSJEFPUSHBUTTON I WS_CHILD I WSJISIBLE 
I WS_GR0UP I WSJABSTOP. 31, 35. 33. 14 
END 
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1. Forward this to Microsoft, and convince them to im¬ 
prove their partition identification code. I agree that in the 
worst case, it is not possible to tell which is the current 
partition. But there are many intermediate cases where it 
is possible. For example, the code could compare the boot 
sector startup code to the one built in the DOS 5+ FDISK 
command. If it is the same, the partition table is compat¬ 
ible. 

2. Distribute a standalone program that creates a swap 
file, without fussing about possible partition incompatibili¬ 
ties. This could include a big waiver declining any respon¬ 
sibility in case of hard disk damage. I did write my own 
during the investigation, to prove that it was the act of 
creating the partition by Windows that did not work, and 
not the usage of the partition itself. The program is in C, 
and is about 1300 lines long. 

(Mr. Larvoire and Hewlett Packard have been kind enough 
to supply the source code for this program, makepar.c. It is pro¬ 
vided on the code disk. Run at your own risk!!! -Iz). 

Following is the official Microsoft article describing this be¬ 
havior. It is reproduced here by permission of Microsoft 

Title: Permanent Swap Files and the Disk Partition Table 

Document Number: Q82373 Pub! Date: 12-MAY-1994 

Product Name: Microsoft Windows 3 Retail Product 

Product Version: 3.10 3.11 

Operating System: WINDOWS 

Reprinted with permission from Microsoft Corporation 


Listing 4 CtrDIg.mak 



# File : ctrdlg.mak 

# Author : Scooper N Ong 

# Date : Sep 7. 1994 

# ****************************************************, 
..AUTODEPEND 

# ‘Translator Definitions* 

CC = bcc +CTRDLG.CFG 

TASM = TASM 

TUB * tl 1b 

TUNIC = tl Ink 

LIBPATH = D:\BORLANDC\LIB; 

INCLUDEPATH = D:\BORLANDC\INCLUDE; 

# ‘Implicit Rules* 

..c.obj: 

$(CC) -c {$< } 

..cpp.obj: 

$(CC) -c {$< } 

# ‘List Macros* 

Link_Exclude * \ 
ctrdlg.res 

Llnkjnclude « \ 
ctrdlg.obj \ 
ctrdlg.def 

# ‘Explicit Rules* 

ctrdlg.exe: ctrdlg.cfg $(Llnkjnclude) $(L1nk_Exclude) 
$(TLINK) /V/S/C/P-/C/A=16/Twe/L$(LIBPATH) m\ 
c0ws.obj+ 
ctrdlg.obj 
ctrdlg.ctrdlg 
mathws.l1b+ 
import.1ib+ 
cws.lib 
ctrdlg.def 

I 

RC ctrdlg.res ctrdlg.exe 


Make a lasting first impression with EDI Install Pro 


EDI Install Pro is a powerful, full featured 
installation toolkit designed to make your 
work as effortless as possible. 

Standard, professional interface. 

Your customers will feel right at home with 
EDI Install Pro's 
standard, profes¬ 
sional interface. We 
don't clutter our 
windows with use¬ 
less gadgets or 
hokey graphics. In 
our opinion, a clean, standard interface, 
makes for a better product and leaves a last¬ 
ing impression. 

No script language to learn. 

Don't waste your time learning yet another 
script language, our simple information file 
makes creating powerful installations a 
breeze. In fact, using the INF Maker utility 
you can complete even complex installa¬ 
tions in less than an hour! 

Includes a complete uninstaller. 

Included with EDI Install Pro is an incred¬ 
ible utility that allows your users to remove 
your applications from their system in one 
easy step! Our uninstaller removes or 
changes .INI files; deletes application files, 



Program Manager groups and optionally 
user data files. 

No hidden costs! 

Unlike some of our 
competitors, we don’t 
charge royalties, and we don't require that 
you purchase a license for each product 
you distribute. Ask our competitors about 
their licenses - you'll be surprised. 


name ♦ Auto font install ♦ Create & mod¬ 
ify .INI files ♦ Cre¬ 
ates Program Man¬ 
ager groups & icons 
♦ Built-in readme 
viewer ♦ Small size 
floppy, hard disk, CD-ROM, Network, and 
e-mail distribution ♦ Ask about our new 
OEM package! 

All this plus much, much more! 






(~80Kb) ♦ Support for 


You'll be in good company. 

What do AT&T, Banyan Systems, Bell Can¬ 
ada, BP Oil, Cirrus Logic, Fannie Mae, East¬ 
man Kodak, NCR Canada, Pacific Bell, Po¬ 
laroid Corp., SunSelect, TRW, Xerox, Ziff- 
Davis Publishing, and the US Army Corps 
of Engineers have in common? They all 
bought EDI Install Pro. Shouldn't you? 


Some EDI Install Pro Features: 

Standard, professional interface; 3D op¬ 
tional ♦ Dithered, tiled or bitmap back¬ 
ground ♦ Bulletin bitmaps (billboards) « 

® Sr r.zf. .. “ 1 j keeps users in- 

—" ^ _| formed ♦ Select¬ 

able components for custom installs ♦ No 
programming required ♦ DLL expandable ♦ 
File compression & splitting ♦ Version re¬ 
source checking » Disk branding with user 


Order Now For Only $179.95! 

See our evaluation version on the BBS, or on 
CompuServe's "WINSDK" torum, file "INSPRO.EXE". 



24-2979 Panorama Drive Telephone/Fax: (604) 945-3198 
Coquitlam, BC V3E 2W8 Eschalon BBS: (604) 945-7602 
Canada CompuServe: 76625,1320 

VISA cards, US/Canadian checks and bank drafts accepted (order forms must accompany all 
draft orders). Sorry, no POs accepted. Canadian residents add 7 % GST. BC residents add 7 % 
PST. Add $10 Shipping & handling ($15 overseas), $20 for Federal Express ($45 overseas). 

All Prices are in US currency. 

For European and multilingual orders, please contact: Windowshare SARL (France), 
voice at (+33) 87-30-85-57, fax at (+33) 87-32-37-75, or CompuServe at 100031,3257. 


EDI Install Pro. EDI Uninstall, and the Eschalon Development Inc. logo are trademarks of Eschalon Development Inc. Other names are (registered) trademarks ol their respective companies. All prices and specifications subject to change without notice. 
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Listing 4 continued 


# ‘Individual File Dependencies* 
ctrdlg.obj: ctrdlg.cfg ctrdlg.c 

ctrdlg.res: ctrdlg.cfg ctrdlg.rc 

RC -R -I$(IHCLUDEPATH) -F0 ctrdlg.res CTRDLG.RC 

# ‘Compiler Configuration File* 
ctrdlg.cfg: ctrdlg.mak 

copy Ml 
-R 
-3 

-f287 

-N 

*v 

*y 

-d 

-WE 

-vl- 

-H=CTRDLG.SYM 

-wbbf 

-wpln 

-wamb 

-wamp 

-wasm 

-wpro 

-wcln 

-wdef 

-wsig 

-wnod 

-wstv 

-wucp 

-wuse 

-weas 

-wpre 

-I$(INCLUDEPATH) 

-L$(LIBPATH) 

-P-.C 

I ctrdlg.cfg 


Can You Browse 
Your Program’s Files? 


{ 

{CL(1]:MA( U Input"):CO("in box") 

[OS("D:\annua 194.wpd"):CL(100):NA("Annual Report"):CO("1994")) 
(ID(/*478*/):CL(200):NA("QuarterIy Report"):CO("Q1") 

IBM ITll'IPTilili timilifei k win M* ^ 1 1 U TTT 'ir M ¥1^'* 1 'Kr < fTr 

[Ul():CL(201):NA("Sales -- Eastern"):CO("not yet available")] 

1 
i 

(CL(2|:NA("Output"):CO("out box") 

[OSf'D: \annua 195. wpd''): CL(100) : NA("Annua I Report") :C0("1995") 1 


US 


The Gamelon Browser. One of the productivity tools included with 
Gamelon, the object-based file API for developers. There’s nothing 
like Gamelon. Create free-form or structured multi-platform files 
easily and save time and money in the process. Available now, single 
-user, rovalty-free. Windows 3.1: $395. OS/2 or Windows NT: $495. 


C and C++ 


gamalon 


M File I/O Library 

Menai Corporation J 

1010 El Camino Real, Suite 370, Menlo Park, California 94025 
1.800.GAMELON . FAX 415.853.6453 • BBS 415.617.5726 . info@menai.com 


The information in this article applies to: 

- Microsoft Windows operating system versions 3.1, 3.11 

Symptom 

When creating a swap file, you may receive an error 
message similar to the following: 

The partitioning scheme used on your hard disk prevents the 
creation of a permanent swap file. 

This error message can display whether you use the 
Virtual Memory dialog box during a custom Windows 
Setup, or the 386 Enhanced option in Control Panel to 
create swap files. 

Cause 

This message can result from one of the following: 

- A partition manager 

- A virus 

- Uninitialized fields in the partition table 

More Information 

One of the checks performed by Control Panel (and 
Setup, because Setup uses Control Panel to create a swap 
file when a custom setup is performed) is to look for disk 
partitioning software, such as Disk Manager or SuperStor. 
This is done by examining the partition table on the disk. 

If partitioning software is found, Control Panel displays 
an error message. This message does not imply that the 
partitioning software is incompatible with Windows; it sim¬ 
ply means that a permanent swap 
file cannot be created on that disk. 

The following conditions can 
cause Control Panel to mistakenly 
detect partitioning software: 

- Another operating system is installed 
on the computer and happens to use 
the same partition type number 
(there are only 255 partition type 
numbers available); that partition is 
detected as one using partitioning 
software. There is no way to work 
around this problem if this is the 
cause. 

- The machine is infected with a virus. 
Some viruses create their own 'for¬ 
eign' disk partitions and set them¬ 
selves up as the boot operating sys¬ 
tem (for example, the Michelangelo 
virus). If no other explanation for the 
disk partition error can be found, the 
disk should be scanned for viruses. 
When the virus is removed, Windows 
should be able to create the perma¬ 
nent swap file. 

- The disk drive may have been parti¬ 
tioned in the past with partitioning 
software, and was later repartitioned 
using MS-DOS version 4.01 or 5.0 
FDISK. MS-DOS and FDISK support 
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only four partitions on a disk, while some partition soft¬ 
ware supports more than four. Therefore, FDISK does 
not reset partitions in the extra entries. As a result, 
Windows interprets these invalid entries as an incom¬ 
patible disk partition. 

- Ontrack Software Disk Manager-N utility partitions and 
formats part of a hard drive as a Novell file server. 
When a machine configured with Disk Manager-N is 
started, the Novell utility attached to the master boot 
record (MBR) loads and gives you the option of starting 
the system on the MS-DOS partition or to the Novell 
file server partition. If your hard disk has been parti¬ 
tioned with Disk Manager-N, you cannot create a per¬ 
manent swap file under Microsoft Windows 3.1. 

The following text was taken from the Disk Manager 

README file: 

DISK MANAGER - N 

DISK MANAGER - N is a disk installation utility tailored spe¬ 
cifically for the NOVELL local area network. This utility re¬ 
places the COMPSURF Utility from NOVELL. DISK MANAGER 
- N installs disks running under NETWARE 86, ADVANCED 
NETWARE 86, and ADVANCED NETWARE 286. 

Additional reference words: win31 3.10 scheme swap- 

file 3.11 Michael Angelo 

COPYRIGHT © Microsoft Corporation, 1994. 


Tech Tips Letters 

Steve Valliere 
Senior Systems Analyst 
Electronic Visions, Inc. 

Cocoa, FL 32926 

svalli@bix.com 

CIS:75020,3477 

W/DDJ, Tech Tips, Leor Zolman: 

After reading about the 'bug* in MessageBoxO in your 
October issue, I had to check this out for myself. I can't 
find the exact reference (Another reader did, see below . . . 
-It.), but I read once that there was a special case of Mes¬ 
sageBoxO for extremely low resource situations. Appar¬ 
ently, combining MBJCONSTOP and MB_SYSTEMMODAL activates 
this feature. Microsoft's documentation for MessageBoxO 
does say that this combination is treated as a special case. 
Since this particular type of box is available regardless of 
memory, it is understandable why none of the flashy 
icons or captions are used. The standard window controls 
(system menu, min/max buttons) don't make sense in this 
situation, either. 

Unfortunately, Mr. Lawless missed a couple of things. 
He states that there is no caption when, in fact, the cap¬ 
tion is displayed above the message text, but within the 
message window instead of in a differently colored bar. 
He also points out a slight documentation bug (inadver¬ 
tently, I think). The manual says 

(continued on page 50) 
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Make project development a 
whole lot easier by picking up a 
copy of MemCheck®. 

MemCheck pinpoints serious C/ 

C++ bugs that other debuggers don't, 
and goes where other debuggers can't. 
You'll find MemCheck's automatic 
bug-spotting absolutely invaluable for 
completing rock-solid projects. 

Resource Roundup 

The new MemCheck V3.0 for 
Windows watches over all kinds of 
things for you, including bitmaps, 
brushes, carets, cursors, DC's, icons, 
menus, pens, memory blocks, timers, 
windows, and more. You'll be notified 
by the exact file and line of errors 
involving over one hundred of the most 
important Windows API calls. 

Debugging Power 
on Tap 

You can use MemCheck 
continuously during 
development — no spot 
checks here. Unlike 



other debuggers, you'll get 
double and triple value as 

MemCheck scouts silently for 
problems in your apps on testers' 
machines or at client sites! It does 
all this automatically. You can even 
use it to debug multiple applications and 
DLL's at the same time, along with your 
favorite conventional debugger. 

Seamless Integration 

MemCheck integrates smoothly into your 
C or C++ projects, and you won't have to 
change a line of code you've written. 
Using MemCheck brings big payoffs in 
time savings for expert and novice 
alike. Call 1-800-933-3284 (1-800- 
WE-DEBUG) today to make your software 
apps the best they can be. International 
callers, call +1-313-996-2944. 
Unconditional 30-day money back 
guarantee on all orders! 

MemQie( 

Automatic Erroi^Jrection Mad< 


"MemCheck is the most valuable tool I use " 

— Ashwin Nirmul/ANSTAT Software 


THIS 

DOS Developer's Special 

Gel MemCheck for DOS, C-Heap Standard and 

The Heap Analyst. A $290 value, SAVE $90! 

Specify Borland or Microsoft. 

..ly $ T 99 

► 

Specify compiler and platform when ordering 


HEWI MEMCHECK V3.0 FOR WINDOWS . S id9 

Upgrade from V2.I - $59. Specify Microsoft C/C++ (7ac- 
8.x, VC++) or Borland C/C++ (3.x, 4.x) only 

MEMCHECK V3.0 PROFESSIONAL FOR DOS... $139 

Specify Microsoft C/C++ (6.X-8.X, VC++), Borland C/C++ 
(BC++ 2.x-4.x), or Watcom C/C++ (9.5) only 

MEMCHECK V2. V FOR ANSI/K&R . $199 

For any UNIX, VAX, or any ANSI C or K & R projects. 
Includes full source code! An unbeatable value! 

u., e wi,h DEVELOPER BUNDLES! 

DOS MASTER PACK . $ 199 

for Microsoft C and Borland C — save $80 ! 

WINDOWS GURU PACK . $199 

for Microsoft C and Borland C — save $80 ! 

MICROSOFT POWER PACK . $199 

for Microsoft C/C++ under DOS and Windows 

BORLAND POWER PACK . $199 


for Borland C/C++ under DOS and Windows 


S/'-. 
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Windows does not automatically break the lines to fit in 
the message box, however, so the message string must 
contain carriage returns to break the lines at the appropri¬ 
ate places. 

Therefore, Mr. Lawless inserted 'Nr' into his message to 
break the strings where he desired, if he had used '\n' 
instead, then he would have been gratified with a new 
line beginning where he wanted. 

I've attached an extremely simple program (Listing 5) 
which demonstrates a system modal message box with a 
title and three lines of text. 

I hope this helps clear up the 'problem' with the Mes- 
sageBoxO API. 


Listing 5 Code demonstrating new lines in a 
message box 


/////umm m m//////un mm ////////////////////////////////// 

♦define STRICT 
llnclude <w1ndows.h> 

Int PASCAL WinMa1n( HINSTANCE hinstCurrent. 

HINSTANCE hlnstPrevious. 

LPSTR 1pszCmdLine. 

Int nCmdShow ) 

{ 

MessageBox( NULL, 

"This Is line number one of the messaged" 

"The second line of the message Is here\n" 

"After the first two, this one is obvious". 

">» System Modal Message Box Test Title «<". 
MB_RETRYCANCEL| MB.ICONSTOP IMB.SYSTEMMODAL ); 

return 0; 

) 

///////////////////////////////////////////////////////////////////// 


Mark R. Szamrej (74261.1263@compuserve.com) also re¬ 
sponded on this issue: 

Leor, 

I enjoy your column in W/DDJ and read it regularly. 
Here are a few thoughts about the HessageBox() bug which 
appeared in the Oct. 94 issue. The bug is not really a bug 
with MessageBoxO. 

Microsoft has documented this behavior as follows: 

When an application calls the MessageBox function and 
specifies the MBJCONHAND and MBJYSTEMMODAL flags for the 
fuStyle parameter, Windows displays the resulting message 
box regardless of available memory. When these flags are 
specified, Windows limits the length of the message box 
text to three lines. 

I can't speak for Microsoft but I see this a being as 'last 
dying breath' message box. A 'regular' message box with 
a title, system menu, and icon consumes more resources 
than this bare minimum version . . . thus the lack of win¬ 
dow dressings. 

The text can be forced to multiple lines by using '\n' 
instead of 'Nr' to separate multiple lines. I hope this helps. 

Finally, Manfred Keul (100031.12@compuserve.com) e- 
mailed with a pointer to article #Q104959 in the MS Develop¬ 
ment Library. This article contains yet additional information on 
resource-starved message boxes. Thanks to all three readers, 
plus any others who may have responded after this column 
went to press, for setting us straight on this matter! □ 


Hands-On Windows Developer Training 


Take Your Pick: MFC or OWL! 


C++ and Windows 
in a Week 

We teach experienced C programmers 

the basics of C++ in two days, then add 
three days of Windows programming using 
a C++ class library. In C++, you learn the 
complete syntax (including templates and 
exceptions), and how to begin “thinking in 
objects.” The Windows course shows you 
how to design and build a modern Frame- 
Document-View Windows application. 
There are two versions: Visual C++ 1.5 
with the Microsoft Foundation Classes 
and Borland’s Object-Windows 2.0. 

Each course has plenty of hands-on 
experience with the developer tools and 
visual assistants provided by the software 
publisher. 


C++ as a “Second Language” 

For programmers who have worked in 
languages other than C. The complete 
C++ language, with object-oriented 
analysis and design concepts. Four days. 
Graduates can enter our Windows course 
on Day 3. Generic C++, not specific to 
Windows and DOS. 

Also Available: 

Intro to Visual Basic Four days. 
Advanced Visual Basic Three days. 

Experience Counts! 

&msg has taught C++ and Windows since 
1989. We have been selected as a 
Borland Connections Training Partner. 
All courses available for onsite 
presentation, including customization. 


UPCOMING PUBLIC COURSES: 

Washington, DC Area 
C++/Win in a Week 

Microsoft Visual C++ 1.5: 
Dec. 12-16 
Jan. 23 - 27 


&msg 

Messaging Systems Group, Inc. 
1559 Rockville Pike, Suite 250 
Rockville, MD 20852 


1 - 800 - 388-3535 

In MD call (301) 230-1840 


Call Today to Register. 
Learn Object Technology 
and Windows NOW! 
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With Class 

Victor R. Volkman 


Introduction 

Object oriented programming requires precise docu¬ 
mentation and definition to be successful. The best way to 
achieve a rigorous specification is with some help from a 
CASE (Computer Aided Software Engineering) tool. With 
Class, by MicroGold Software (Bridgewater, NJ), is a Win¬ 
dows CASE tool tailored to this task. Specifically, With 
Class encompasses the following software development 
functions: 

• Creating class diagrams 

• Creating the data dictionary 

• Generating C++ code based on above 

• Creating class diagrams from C++ source code (reverse 
engineering) 

With Class supports the major 00 methodologies: 
Rumbaugh OMT, Booch OOD, Coad/Yourdon OOA/OOD, 
Shlaer/Mellor OOA/OOD. You may manipulate entities 
representing systems, classes, objects, attributes, and op¬ 
erations. With Class can build relationships based on gen¬ 
eralization (inheritance or 'is a'), association ("has a'), ag¬ 
gregation ('part of'), or messages (calls). 


With Class vl.5 (04/28/94) 

Author 

Michael Gold 

MicroGold Software 

696 Birch Hill Drive 

Bridgewater, NJ 08807 

1-908-722-6438 

1-212-744-8688 

Email: CIS [71543,11721 

Registration 

Shareware Educational version $59. 

Professional version $149 plus shipping and 
handling. 

Evaluation 

30 days. 

Where to get It 

The oak.oakldnd.edu anonymous ftp server 
(Oakland University, Rochester, Michigan) in 
the /pub/msdos/windows3 directory as 

UCLASS15.ZIP. You may also want to get 
StateMaker (STATE31.ZIP) while you're there. If 
you're outside the U.S., please use the Internet 
ARCHIE utility to locate a closer FTP server. 

Download it from CompuServe: 

Type GO MSMFC in Library 8 Doc/View/VI 

Download it from: 

HAL 9000 BBS: +1 313 663 4173 or 

663 3959 speeds from 2400 to 28800 bps. 


Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a contributing editor to 
Windows/DOS Developer's Journal since 1990. He is currently employed as Senior Analyst at H.C.I.A of Ann Arbor, Michigan. He 
can be reached by dial-in at the HAL 9000 BBS (313) 663-4173, by Usenet mail to sysop@hal9k.conv or telnet hal 9k.com. 












Based on class diagrams you create, With Class gener¬ 
ates ANSI C++, Borland C++ with OWL 1.0, or MS Visual 
C++ with MFC 2.0. With Class generates all the following 
in C++ code: 

• Class header 

• Default and copy constructor 

• Constructor with arguments 

• Destructor 

• Assignment and equality operators 

• Base/derived classes 

• Data members for 1:1 and 1 :M association/aggrega¬ 
tion, 

• Insertion operator (operator«) 


• Extraction operator (operator») 

• Accessor functions ('get' and 'set') 

• Function templates 

Installing With Class is as easy as unzipping the archive 
into an empty directory on your hard disk. No setup pro¬ 
gram is provided. 

In the remainder of this article, I'll examine aspects of 
using With Class for class diagrams, data dictionaries, and 
C++ code generation. 

With Class and 00 Design 

The With Class tutorial identifies three primary types of 
documentation for modeling your application: diagrams, 
text specifications, and code. A brief 
look at these documentation types 
will clarify the role of With Class in 
your development environment. 

With Class specifically supports 
the class diagram (see Figure 1) and 
message diagram (event flow). State- 
Maker, a companion product by Mi- 
croGold, supports creating state dia¬ 
grams. Other formal diagrams, such 
as system drawings and interface 
drawings, can be created using With 
Class or your own favorite illustration 
tools (e.g., CorelDraw). 

Text specifications supplement the 
entities and relationships represented 
graphically by diagrams. Typical 
modeling will include requirements 
statements, data dictionaries, class 
specifications, message lists, and 
message scenarios. You can use the 
text editor supplied in With Class or 
your own favorite editor. 

Code generation is also an essen¬ 
tial aspect of modeling. This ensures 
that code you use matches the speci¬ 
fications you originally desired. Both 
With Class and StateMaker generate 
the initial C++ code you'll need. 
Though With Class allows you to 
generate a class diagram from exist¬ 
ing C++ code, you would not nor¬ 
mally take the generated class dia¬ 
gram and re-generate the initial C++ 
code from it. 


ADVANCED 
SOLUTIONS 
FOR C/C++ 
PROGRAMMERS 


If you program in C/C++ you need the 
solution-oriented information found only 
in C/C++ Users Journal. We devote 12 
issues every year to the language of 
choice, C/C++. Each issue is crammed 
with information on ANSI C, C++, de¬ 
bugging, tutorials, code and more. 

A FREE issue of C/C++ Users Journal 

is yours — call now and ask for a trial 
subscription. If you like the code-inten¬ 
sive C/C++ programming solutions you 
find in your FREE issue, pay only $29.95 
for a full year’s subscription. If not, write 
‘cancel’ on the accompanied invoice 
and owe nothing. There’s NO RISK and 
NO OBLIGATION. 


e/o 


++ 

Users lournat 


Advanced Solutions for C/C++ Programmers 


Software Tools 


• Analyzing Inputs 

of Unknown Syntax 

• Standardizing 
Standard C 



Chuc It Allison 
Km Rugh 
Victor R. Volltman 


0 


• Structure Mapping 


tom*' 

c 


Try a 

FREE ISSUE 


C/G 


++ 

Users lournal 


Advanced Solutions for C/C++ Programmers 

1601 West 23rd Street, Suite 200 
Lawrence, KS 66046 USA 


CALL: 913-841-1631 
FAX: 913-841-2624 


Non U.S. orders must prepay ($46 Canada/Mexico, $65 outside North America) in U.S. funds. 


Diagramming in With Class 

With Class uses a painting meta¬ 
phor for creating class diagrams. Ac¬ 
cordingly, you start a new project on 
a blank canvas and primarily use two 
floating palettes: Tools and Draw. All 
diagrams are stored in a proprietary 
file format with the extension .omt. 

The Tools pallete includes opera¬ 
tions to manipulate entities with the 
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class and relationship tools, zoom in and out, and control 
code generation options (see Figure 2). The Draw palette 
contains rendering tools typical of common illustration 
programs: draw rectangle, oval, line, arrow, arcs, and text. 
The Draw tools are for illustration only and hence do not 
affect code generation. 

As mentioned earlier, With Class supports Rumbaugh, 
Booch, Coad/Yourdon, and Shlaer/Mellor diagramming 
methodologies. You can switch diagramming methodolo¬ 
gies at any time and the screen will refresh itself to reflect 
the new methodology. This allows you to communicate 
with other people who may be unfamiliar with your se¬ 
lected methodology. 

The ability to edit multiple diagrams simultaneously us¬ 
ing the Windows Multiple Document Interface (MDI) would 
simplify managing multiple projects. Currently, With Class 
can have only one diagram open at a time. 

The diagram editor can interact with other Windows 
applications by copying data to the Windows clipboard. 
However, you cannot paste data from other programs 
back into With Class. Some Dynamic Data Exchange (DDE) 
and Object Linking and Embedding (OLE) is planned for 
future releases. 

Data Dictionaries in With Class 

The data dictionary lists and describes key 00 entities 
and terms. Information on classes includes purpose, attrib¬ 
utes, and operations. When you choose 'Generate Data 
Dictionary" from the menu, With Class dumps the entire 
data dictionary to a file with .die extension. The data dic¬ 
tionary is in a plain ASCII text file and thus can be han¬ 
dled with any editor (see Figure 3). 

Information accumulates in the dictionary as you add 
classes to your diagram (.omt file). Entries are also added 
when you define relationships between classes. Double¬ 
clicking on a class or relationship automatically brings up 
an entity editing dialog box. For example, double-clicking 
on a class lets you edit its list of member functions and 
private data elements. 


Documentation, Licensing, and Support 

With Class includes three primary sources of documen¬ 
tation. The first is a two-part tutorial by Richard Felsinger 
entitled 'Object-Oriented Modeling - With Class and State- 
Maker' and 'Modeling and Prototyping Systems.' First-time 
users should read these tutorials immediately and resist 


TWAIN support for your application BIS'Rt 


[7| Do you want to support scanners with your 
Windows application? 

[7] Do you think it makes sense to support the 
industry standard TWAIN? 

[7] Do you want to save your resources? 

[7] Do you want to save money and time? 

The TWAIN Integration Kit™ is the best choice to 
implement TWAIN in MS-Windows applications. 
Forget about the estimated 20 ’man days’, for the de¬ 
velopment of a TWAIN implementation. With the TIK 
you have TWAIN in your application within a day or 
less. For the value of only a few ’man days’, you will 
get the powerful and easy to use TIK DLL. The Price 
is only $1995 and no runtime licenses are payable. 
Order now or test the trial version first with a subset 
of commands for only $250. We anxiously await your 
order or inquiry for further details on the TIK. 


30-DAY MONEY-BACK GUARANTEE 


JUNGCLAUS SOFTWARE ENGINEERING P.O. Box 270 202 

D- 40525 Duesseldorf Germany 
FAX+49 211 562 31 12 CompuServe 100334.2207 




Free demo available via CompuServe Download TIKDEMO from WINSDK forum, section Public Utilities 
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Figure 3 Data dictionary example 

Data Dictionary 

float gasQty - 
float maxGasQty - 

System Specification 

float minGasQty • 

— Class Information — 

0perat1ons(C++ Functions): 

- Car - 

float getGasQty 0 - 

Visibility - exported 

void setGasQty (float aGasQty) - 

Cardinality -n 

Concurrency - sequential 

void start 0 - 

Persistence - transitory 

Description - This is a simple model of a 

- Motor - 

system which simulates an automobile 

Visibility - 

Attributes(C++ Data Members): 

Cardinality - 
Concurrency - 


the temptation to jump in and start 
playing with the product. Felsinger 
systematically describes object-ori¬ 
ented design nomenclature and phi¬ 
losophies in a manner even those 
without formal design experience can 
absorb. The documentation could be 
much improved with the addition of 
graphics. The tutorials are in Win¬ 
dows Write (.wri) and suitable for 
printing or viewing. 

The second component of the 
documentation, a 28-page 'User 
Manual,' provides an authoritative 
reference for features and functional¬ 
ity in the product. It covers each 
menu pick and toolbar button in de¬ 
tail. Appendices include a complete 
bibliography and a glossary of ob¬ 
ject-oriented design words. 

Last, With Class includes small bits 
of documentation in a Windows Help 
(.hip) file. Help is accessible only from 
the menu. The help file would be 
more useful if it provided context- 
sensitive help in the program. 

Since MicroGold markets With Class 
as shareware, you must register it if 
you wish to use it beyond the 30-day 
evaluation period. You can register 
With Class by credit card through Com¬ 
puServe (GO SWREG) or by calling Mi¬ 
croGold directly. The evaluation ver¬ 
sion by MicroGold, also referred to as 
the Educational version, supports up to 
15 classes per document. For $100 
more, you receive the Professional ver¬ 
sion, which offers unlimited class sup¬ 
port plus additional C++ code genera¬ 
tion features. There are no runtime li¬ 
censing requirements. 

Registering the product at the Edu¬ 
cational version level entitles you to 

(text continued on page 58) 


Rev Up Database 
Programming 

with Greenleaf Database Library 



Powerful Functions 


□ The SoftC Database Library 
is now the new Greenleaf 
Database Library. 

□ Unsurpassed speed and 
flexibility for access to 
industry standard database 
data, index, and memo files 
at an affordable price. 

□ Databased Advisor says, 

"SoftC Database Library has 
top ratings!" 

□ Don't be fooled by pretty 
ads—the Database Library is 
all you need to interface 
with dBASE III, dBASE IV, 
FoxPro, FoxBASE, Clipper, 
dBXL, and other xBASE files 
including new FoxPro CDX 
index files. 

□ Supports MS-DOS, 
Windows™, and is portable 
to OS/2, UNIX. 

□ Includes Windows 3.1 DLL, 
supports Microsoft, Borland 
and Zortech C/C++. 

□ Single and Multiple User; 
Network acccess fully 
supported. 

□ Database package not 
required—this product is a 
complete ISAM library. 

□ Windows DLL linkable with 
most DLL-capable compilers 
(including Visual Basic). 


All Greenleaf Libraries Feature: 

□ No royalties 

□ 90-day money-back guarantee 

□ FREE unshrouded source (ANSI & K&R) 

□ FREE unlimited tech support 

□ Top rated documentation AND online 
documentation with FREE help engine! 

□ FREE BBS access, quarterly newsletter 

□ GOLD support available: toll-free access to 
BBS, tech support and free updates—call for 
prices 

Database Library v3.22 .. $249 

Call today for complete infor¬ 
mation, demo, or to order. Mas¬ 
terCard, VISA, AmEx, approved 
purchase orders. 

1 - 800 - 523-9830 

214-248-2561 
FAX 214-248-7830 
BBS 214-250-3778 

Greenleaf Software, Inc. 

16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 

m 
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Information in the advertisement. 


vudrs@rdpub.com 
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wdrs@rdpub.com. Make sure you 
include this magazine's Issue 
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(text continued from page 55) 

technical support via email. Registering at the Professional 
version level also provides unlimited telephone technical 
support. Registrants of either version receive a correspond¬ 
ing version of StateMaker, a CASE tool that creates state 
diagrams and generates C/C++ code. 


Conclusion 

With Class provides a graphical class diagram and mes¬ 
sage diagrams that support a variety of popular method¬ 
ologies. For new projects, you can take advantage of With 
Class code generation features to improve consistency and 
reduce errors. For existing projects, you can effectively docu¬ 
ment what you have done so far. In either case, With Class 
lets you see your own class system in a new perspective. □ 


Figure 3 continued 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Byte's Windows 
Programmer's Cookbook 
L. John Ribar 
254 pages 

Osborne McGraw-Hill, 1994 
ISBN 0-07-882037-5 

Byte's DOS Programmer's 
Cookbook 

Craig Menefee, Lenny Bailes, 
and Nick Anis 

298 pages 

Osborne McGraw-Hill, 1994 
ISBN 0-07-882048-0 

Byte's OS/2 Programmer's 
Cookbook 

Kathy Ivens and Bruce Hallberg 
273 pages 

Osborne McGraw-Hill, 1994 
ISBN 0-07-882039-1 



Each costs $34.95 and includes a CD-ROM. 


I am reviewing these three books as one because they 
are all based on the same formula, but I will begin by 
looking at the 'programmer's cookbook' for Windows. 
The subtitle of each of these books is "Secret Recipes for 
the Serious Code Chef.' Recipes? Cookbooks? Are you ex¬ 
pecting some cool code and algorithms? The back of the 
Windows version says you'll find 'the best-kept secrets 
and newest programming tips for Windows' inside. Are 
you expecting elegant Windows programming techniques 
and undocumented API functions? Surprise - each book 
contains short descriptions of shareware programs (the ex¬ 
ecutables are on the CD, which is glued and sealed to the 
book in a most inconvenient way - get out the butcher 
knife), many of which have virtually nothing to do with 
programming! Saying the book contains secrets and pro¬ 
gramming tips is about like saying the dictionary contains 
short stories - you probably can't be sued for false adver¬ 
tising, but a few people are going to want their money 
back. 

The bulk of each book is short synopses of shareware, 
freeware, and public domain software that resides on the 
accompanying CD-ROM. Each package gets about five or 
six paragraphs of description (long on fluff, short on hard 
technical information). There are also 'tips,' such as: 'don't 
kill tasks unless you're sure what they're for, or you might 
hang the whole system!' And there are 'quotes,' equally 
devoid of useful technical information, from programming 
luminaries such as W.C. Fields, Stephen Wright, Fats Dom¬ 
ino, and others. The Windows version includes lots of 
games and entertainment (been desperately looking for 
that cow screen-saver? Here it is!). This is where the 
author seems to have invested the most research ('Why a 
Star Trek game? I've found that the 'Star Trek' series is 
highly favored among many programmers.'). 


You can order any of the books that appear in Books in Brief from R9D Publications by calling (913) 841-1631, faxing 
(913) 841-2624, or sending email to rdorders@rdpub.com. if using fax or email, send the book title, author, and publisher 
along with your MasterCard or Visa number, expiration date, and phone number. 
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To be fair, there are also worthwhile entries in the Win¬ 
dows book. It includes well-known editors like E! and 
WinEdit, some file programs, a disassembler, some date 
manipulation code, and so on. Also, the DOS and OS/2 
books are not nearly as frivolous as the Windows book, 
managing to avoid focusing on games, sounds, and bit¬ 
maps. The OS/2 book took the tack of announcing up 
front that it is not just for programmers (too bad they left 
the word 'programmer' on the cover!) and the DOS book 
just plain did a much better job of including technically 
interesting and useful software. However, there are a 
great many good public domain and shareware offerings 
for DOS, Windows, and OS/2 programmers that are not in 
these books. Why? The CD that comes with the Windows 
book contains less than 49Mb; in other words, it is 90 
percent empty (the other books come with CDs that are 
equally jam-packed with nothingness). 

Regular readers of this column know that I am always 
on the lookout for the most mistitled programming book 
in the world. The competition is extremely fierce, but I be¬ 
lieve this series of books is a serious contender. The basic 
idea, to fill a CD with the best of freeware and shareware 
offerings for programmers, was a good one. The imple¬ 
mentation ranges from quite poor (the Windows version) 
to not-a-ripoff-but-not-nearly-comprehensive (the DOS 
book). If you call yourself a programmer but do not actu¬ 
ally write code on a regular basis, you may find the Win¬ 
dows or OS/2 books enjoyable. If you subscribe to this 
magazine, though, you definitely will not find the Win¬ 
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dows cookbook worth the money. Instead, put that 
$34.95 toward the purchase of the CICA Shareware for 
Windows CD-ROM (not 90 percent empty, $29.95 from 
Walnut Creek, 800-786-9907) or one of the shareware 
collections from EMS Professional Shareware (301-924- 
3594) or similar companies. 



Managing Software Maniacs 
Finding, Managing, and Rewarding a 
Winning Development Team 
Ken Whitaker 
$27.95 
230 pages 
Wiley, 1994 
ISBN 0-471-00997-0 


I think it was PC Magazine that used to run a hilarious 
comic strip called 'Two-Fisted Management.' In my favor¬ 
ite episode, in the middle of an average workday a fire 
alarm rings, and the two-fisted manager stomps from of¬ 
fice to office, kicking and shoving people out the door, 
shouting 'Out! Take a hint and take a hike!' After shoving 
the last employee out the door, he yells 'And stay out, 
you lousy profit-sharing parasites!' Everyone stands 
around until the two-fisted manager turns and walks back 
in the building and then someone in the crowd says 'Jeez, 
ya never know when Mr. Harris will run a 'fired drill'.' 
What made the comic strip so funny was, no matter how 
outrageous the cartoon, you could always recall even 
more outrageous real-life management episodes. 

Managing Software Maniacs is much more humane than 
the two-fisted manager, but it still pretty much reinforces 
my low opinion of the state of software management. In 
this book, programmers are not people, they are the 'nerd 
herd,' 'prima donnas' who tend to 'become full of them¬ 
selves.' Programmers are things that need to be 'moti¬ 
vated,' and to 'buy in.' You won't find any little stories 
here of how a programmer raised a concern that resulted 
in the author learning how to be a better manager. But 
you will find fondly recalled episodes of programmers he 
fired on the spot, or slapped down during a one-on-one 
meeting. In this book, programmers are not just objects, 
they are homogeneous objects - one solution works for 
all of them. Here, you will discover how to attract good 
programmers (they're not individuals, so they will all be 
attracted by the same thing), reward them (one style of 
reward works for all), and motivate them (with inspira¬ 
tional bons mots such as 'You are the company!'). 

I laughed out loud when I read a section that began 
'My development managers and I determined that pro¬ 
ductivity was being negatively affected by excessive noise 
in the office.' There's nothing like paying a gaggle of 
managers $80K per year to 'determine' things, rather than 
just walking up to the folks who do the work and asking 
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'Urn, what can we do to make you more productive?' I 
can just imagine what really happened: the programmers 
had been complaining about the noise for about six 
months when finally one of them got smart and figured 
out that the only way anything would get done was if the 
managers were tricked into thinking it was their idea. 

Like most books in the programming arena, this one 
has faults that a strong editor could have helped remedy. 
I am always a little taken aback when someone produces 
a book on a subject that has been studied and researched 
for about 100 years, and they include no reading list, bib¬ 
liography, or references to other works whatsoever. It's 
like the author is saying 'I never read anything anyone 
else has to say on this subject, but I bet everyone will 
want to know what I have to say.' The book also rambles 
off-topic, although this is mostly confined to the final 
chapter, which exhibits the classic amateur writer's disease 
of other-stuff-l-always-wanted-to-say-if-l-ever-wrote-a-book. 

What I'm really railing against here is not this book so 
much as the system that spawns it. The average manager 
of a group of programmers got that position by being a 
good programmer, not by exhibiting any particular gift for 
management. Once you are promoted via the Peter Princi¬ 
ple in this way, you can probably look forward to about 
60 minutes of management training from your company. 
As a result, the typical software manager is pretty much 
ignorant of the large and thriving body of information on 
the subject of management, both academic and popular. 
After some years, such a manager is qualified to write a 
book like this one, full of war stories, opinions proven to 
work within the narrow scope of his/her own career path, 
and a hodgepodge of rules of dubious generality learned 
by guess and by golly. 

My negative comments notwithstanding, Managing Soft¬ 
ware Maniacs could be worth a read, not as it was in¬ 
tended (the definitive guide to techniques that 'really 
work'), but as a look at one individual manager's opinions 
and techniques. One can almost always learn something 
of use by taking a detailed peek at how someone else 
does a job. If you've just been promoted to a manage¬ 
ment position over a band of hapless former co-workers, 
do the world a favor and treat management as a skill that 
can be studied and learned. Check out the library and 
your local bookstore and begin to get acquainted with 
what may be the only field producing as many books as 
computer programming does. Take some time to read 
some classics, even musty old texts like Peter Drucker's 
The Effective Executive (decades old and still quite relevant 
even to people who manage only themselves). In my 
opinion, the only good managers are the ones who know 
they are still learning. 


Inside the Windows NT 
File System 
Helen Custer 
$9.95 
98 pages 
Microsoft Press, 1994 
ISBN 1-5561 5-660-X 


I am biased towards this book, and my name even ap¬ 
pears in the preface, although I contributed nothing con¬ 
crete towards its creation beyond a casual 'Hey, that's a 
good idea for a book!' Therefore, read these comments at 
your own risk. 

One of the bad things about Inside Windows NT is that it 
pretty much had to ship before the operating system did. 
One subject that got left out was NTFS, the new file sys¬ 
tem that NT supports. This monograph (a fancy word for a 
small book) is small in size (about 90 pages) and price 
(about ten bucks), and you can view it as one of the 
'missing chapters.' Like Inside Windows NT, this is not a 
book of API functions and data structures, but a descrip¬ 
tion of the overall design of the software. Ten bucks to 
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understand the design of NTFS is a better deal than you'll ers on this topic begin appearing as soon as they have 

get from any conference or seminar (expect to see speak- time to read the book). 

The writing is clean and clear, the 
kind that makes you feel like you are 
quite smart, since you can under¬ 
stand the material so quickly. There 
are more helpful figures and dia¬ 
grams in this tiny book than in 90 
percent of the full-size books that 
cross my desk. The chapters include: 
Why Create Another File System?, 
The NTFS Model (from various an¬ 
gles, NTFS is just an installable driver, 
a relational database, or just another 
class of NT objects), File System Struc¬ 
ture, Recoverability, Volume Manage¬ 
ment and Fault Tolerance, Data Com¬ 
pression, and MS-DOS File Name 
Generation. Now how can there be a 
chapter about data compression 
when Windows NT v3.5 does not 
support data compression? Well, as 
best I've been able to determine, 
data compression will appear in 
some intermediate NT update Real 
Soon Now, so be the first on your 
block to understand how it works. 

One reason I wanted to mention 
this book in this column is that it 
seems to be something of a well-kept 
secret. I have the impression that few 
copies were printed; certainly I have 
not been able to find it in any of the 
technical bookstores I haunt on a 
regular basis (there's an absolute glut 
of copies of Inside Windows '95, 
though). There even seemed to be an 
unexpected shortage at the recent 
Microsoft conference for Windows 
NT file system writers. I had to use 
nefarious means to obtain my copy 
from the Microsoft company store for 
employees; if it's this hard to find 
now, it may be a collector's item by 
next year. If you're having trouble 
finding this book, send email to rdor- 
ders@rdpub.com (or call 913-841-1631 
and ask for Customer Service) and 
see if we've managed to get some in 
stock. 

Reflections on 1994 

If you are reading this column, 
you are a member of a minority that 
I hold dear - the relatively small per¬ 
centage of programmers who actu¬ 
ally read books and magazines to 
stay current or improve their skills. 
The sad truth is that the majority of 
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programmers pretty much stop reading about program¬ 
ming after they pass that last college course and land a 
job. If we are such a minority, then how do I explain the 
current glut of programming books? I believe this mainly 
comes from the fragmentation of the publishing market. 
These days, a publisher can publish and distribute a fairly 
small number of copies of a particular book relatively in¬ 
expensively. If the book does well, the publisher can then 
invest in a larger press run and, if not, the book can be 
abandoned, hopefully having at least paid for its develop¬ 
ment costs. 

I think the modern nature of book publishing also ex¬ 
plains the generally poor quality of programming books. It 
may sound cold, but one can make a case that it is really 
in the publisher's best interest to invest as little as possible 
in each book, while producing as many different books as 
possible. Resources can then be focused on the minority 
of those books that turn out to sell well. A publisher could 
easily go broke investing a lot of resources in producing a 
quality book that only 3,000 programmers are going to 
read. On the one hand, publishers can now afford to pro¬ 
duce a book of interest to only 3,000; on the other hand, 
they can't afford to work very hard at making it a quality 
book. 

Despite the nature of this marketplace, good books do 
happen. Often, this is because the book was a labor of 
love for the author. Remember, when you hand over your 
credit card for that $29.95 book, the author is lucky to get 
one or two dollars from that sale - the people who write 


a programming book to get rich are almost always in for 
a rude shock. Even bad books take significant effort on 
the part of authors, and every author who successfully 
completes a book at all should rightfully view that as an 
accomplishment. Still, my main loyalty must lie with the 
folks who buy books, not the ones who write them. I 
hope this column will help stimulate conversations about 
programming books and will spread information that 
helps people find the books they can really use, thus help¬ 
ing them avoid that sinking feeling that comes when you 
get 20 pages into a $40 book and realize it does not have 
the information you need. 

Best Books of 1994 

My library has always held hardware books, but only 
this year does it hold hardware books that I turn to with 
confidence. Frank Van Gilluwe's The Undocumented PC (Ad- 
dison-Wesley, 1994) is loaded with the kind of detailed 
information that only comes with experience and an ob¬ 
session with understanding why things work the way they 
do. This book is part of the 'Andrew Schulman Program¬ 
ming Series' which is one of the few monikers I associate 
with above-average quality. Equally useful, and yet of a 
totally different style, Hans-Peter Messmer's The Indispensa¬ 
ble PC Hardware Book (Addison-Wesley 1994) is a huge, 
detailed compendium on the same subject. Crammed with 
figures, tables, and diagrams, reading like an encyclope¬ 
dia, it is easier to name the subjects this book doesn't 
cover than to name all the ones it does. At about 1,000 



Integrate Your DOS Applications 
With Windows Using 


Add Graphs, Dialog Boxes and 
Clipboard support to your DOS 
applications. 


Extend your 
DOS 

applications 
and integrate 
them with 
Windows 
applications. 

We support 
Clipper, FoxPro, 
dBase, C/C + +, 
Basic and Batch 
files. 



1-800-484-2045 x 3000 


J J SOFTWARE no 


P.O. Box 675573 Marietta, GA 30067 
404-952-2432 FAX 404-955-1375 


From DOS 

$59 


□ Request Reader Service #321 □ 



For SDK & Visual Basic 

3D Chart 

- Over 30 of 2D & 3D chart styles 

- Rotation & scrolling 

* Supports printing & clipboard 

Toolbox 

- Creates buttons from bitmaps 
or text 

- Supports scrolling 

• 3D buttons w/ color customization 

- Single/multiple/no-state button 
groups 

Ribbon 

- 3D items with color customization 

- Supports combobox, text, & buttons 

Field Validation 

- Validates date, time, number fields 
& "PIC" statements 

Meter 

- Creates vertical, horizontal, & 
circular gauges with choice of 
needle or color bar as indicators 

- Linear & logarithmic scales 

Table 

- Column & row split windows 

- Multiple row & column selections 

- Check boxes/radio buttons/bitmaps/ 
editable/combobox column 

- Input validation 

- Color customization 

Status Bar 

- Auto scrolled text 

- Stretchable field width 

- Colored progress bar 

- Show date, time, & key states 


Source code for the 
Borland 3D Chart is available! 



Split windows 



Consulting & 

Contract Programming Available 


Free Demo from BBS. 

No Royalties. 30-day MBG. 
Optional with source code. 


Tel: (408) 263-9881 
Fax: (408) 263-9883 
BBS: (408) 263-0892 


Kansmen Corporation 
P.O. Box 360070 
Milpitas, California 95036 
USA 


□ Request Reader Service #247 □ 

Windows/DOS Developer’s Journal — Page 63 


December 1994 































































pages, I don't know if it can physically be made any big¬ 
ger, but I sure hope he updates it to include the Pentium 
and various other recent PC hardware developments. 

Some old standards were revised this year, and you 
might want to update your library accordingly. There were 
new editions of PC Interrupts (by Ralf Brown and Jim Kyle), 
and Undocumented DOS (by Andrew Schuiman, Ralf Brown, 
David Maxey, Raymond J. Michels, and Jim Kyle). The for¬ 
mer grew big enough to have its own spinoff: Network 
Interrupts (also by Ralf Brown and Jim Kyle). Ail three 
books are from Addison-Wesiey. 

The great Graphics Gems series had a new installment 
this year - Graphics Gems IV, edited by Paul S. Heckbert 
(AP Professional, J 994). Each book in the series is a collec¬ 
tion of the best tips and techniques (some with extensive 
ready-to-use code) submitted by a wide variety of graphics 
programmers from universities and companies like Silicon 
Graphics and Industrial Light and Magic. If your graphics 
programming consists of lines and circles and the odd 
BitBltO, don't bother, but if your second edition of Foley 
and Van Dam is already well-thumbed, this series is for you. 

Another name I associate with quality is O'Reilly & As¬ 
sociates; they mostly publish UNIX-related material, but 
their new Encyclopedia of Graphics File Formats (by James D. 
Murray and William vanRyper) will be of interest to graph¬ 
ics programmers of every platform. It briefly covers more 
formats than any book I've seen and comes with a CD- 


ROM that contains the complete, original specifications for 
many of the formats. I like this book as much for what it 
is as for what it might become - hopefully readers will 
give them lots of feedback and the second edition will 
have even more file formats with more detailed and use¬ 
ful code and descriptions. 

Michael Abrash wrote a book on optimization some 
time ago that pretty much disappeared in some kind of 
confusing publishing snafu. Even though it did not reach a 
great many programmers, it developed a loyal following. 
Now, some of that material, along with new material, has 
emerged in his new book Zen of Code Optimization (Coriolis 
Group Books, 1994), and it includes information on the 
Pentium. If you write assembly language for the PC, this 
book is definitely worth a read. If all Abrash's book ever 
accomplishes is to teach people to measure before they 
talk about efficiency, his efforts will have been well-spent. 

Let's Talk Books 

Did you discover a new programming book you love 
or hate? Drop me note (send email to 70302.2566@com- 
puserve.com) and tell me about it. Just make sure to in¬ 
clude the title, author, and a succinct description of why it 
was or wasn't a good investment for you. I'll try to fit 
some of your feedback in this column. Here's hoping 
1995 will yield a bumper crop of good programming 
books. □ 
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Paul Bonneau 


Send questions to Paul via Internet as 
paul@rdpub. com 
from CompuServe: 

>INTERNET:paul@rdpub. com 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

The volume of questions and com¬ 
ments for Paul is now such that he will 
be able to respond only to messages 
he will address in the column. He defi¬ 
nitely wants to hear from you - he 
just may not be able to let you know 
that personally. 


In this month's column I catch up on the mail, responding to readers' comments, 
questions, corrections, and improvements on items fpom earlier columns. Thanks to all 
who wrote. 


eE3= 

Visual C++ vl .5 

1 Borland C++ v4.0 


Symantec C++ v6.1 


Q A friend passed along your column (the August 1994 issue) on calling the 
Shell virtual device to create a VM for a DOS app. I've converted it to a 
DLL but am having a strange problem. The passing of parameters to the func¬ 
tion is not working. If I modify your dosapp.c to also print its arguments, when I 
run: 

c:\test\dosapp.exe aaa bbb 

I get echoed 'aa', 'bbb', and 24 other such items. If I precede my arg string by 
a space, it always reports nine arguments ( argc-1 ) regardless of the actual line! 
Yet the argv array has the pointers right! After a bit of tinkering, I've discovered 
that the argument pointer must point to a string whose first byte is the length 
of the argument string to follow. Anyway, this seems to work! 

Now I'd like to find out how to run a batch file via comand.com. The obvious 
doesn't work. By the way, there is a typo (page 13) in the for loop that gets 
the working directory. 

Steve Alpert 
sra@idx.com 

A Thanks for pointing out the command argument number prefix. I should 
have caught this when I was playing with the Microsoft VC++ 1.5 com¬ 
piler. When the IDE (integrated development environment) calls down to the 
DOS-hosted compiler, it prefixes the command-iine string with a length byte 
that includes the entire length of the string (including the length byte and the 
null terminator). However, I don't know how important use of the length byte is. 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft. 
























I modified the program that creates hidden VMs 
(createvm.c) in various ways, and it appears that the lead¬ 
ing byte of the command-line string is simply ignored, and 
that the argument string is broken into white space-sepa¬ 
rated words until a null terminator is encountered. 

In a subsequent conversation with Steve, I learned that 
he had discovered that it is possible to invoke commnd.com 
to run a batch file. The requirements are that a full path 
to the batch file be provided, and that the 7c" command 
be supplied to the command interpreter (exit the com¬ 
mand interpreter upon completion of the command). 

The bug in the for loop you pointed out is embarrass¬ 
ing. The original code looks like this: 

for (pch = szPath + 

GetModuleFileName(hi ns. szPath, 
sizeof szPath) - 1; 

pch >= szPath; pch--) 

if (*pch == '\V 11 *pch == ':') 

{ 

*pch = 0; 
break; 

} 

I have been forced to mess with DOS paths for years now, 
you'd think I would finally have it straight! First off, the 
Windows API routine GetModul eFil eNameO always returns a 
fully qualified path. So the test for the colon is super¬ 


fluous, since a backslash ("V) will always be encountered 
first. This isn't so bad, but what is bad is if the path is at 
the root. In this case the szPath variable ends up with just 
the drive letter and a colon, making it incorrect for use as 
the working directory argument. I have added code to 
createvm.c (Listing 1) to fix this special case before initializ¬ 
ing the working directory pointer of the shell execute 
block (SEB). 

I also modified createvm.c to invoke a batch file via com¬ 
mand. com. A small complication is that the SEB's executable 
pointer must be set to the full path to the command inter¬ 
preter. Fortunately, the COMSPEC environment variable 
can be used to locate command.com. The SEB's argument list 
has also been modified to pass the 7c' flag, the full path 
to the batch file to run (I have used the innovative name 
'dosbatch.bat'), followed by the arguments to the batch 
file. I formatted the string one byte past the start of the 
output buffer so that the length prefix could then be 
placed into that first byte. 

The sample batch file just echoes its arguments to the 
file dosapp. txt: 

@echo 561 562 563 564 565 566 > dosapp.txt 

Running createvm.exe thus results in the creation of the file 
dosapp.txt in the same directory as createvm.exe and con¬ 
taining the string 'one two three four'. 
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Q Despite your exchange with Clifton Christian in the 
September W/DDJ, the sound functions of Windows 
3.0, such as SetVoiceSoundO, haven't exactly disappeared 
under 3.1. They are just harder to access and less reliable. 

The following bit of Pascal code makes the old Win¬ 
dows sound functions work under Windows 3.1 when you 
are using the PC Speaker Driver. (I haven't tried it with 
sound cards, where it probably wouldn't work since all it 
does is directly manipulate the speaker port.) I don't know 
why this works, but it does. 

procedure BeepEnable; 

{ to enable musical tones after } 

{ playing a .WAV file } 
var InPort61: Byte; 
begin 

Port[$43] := $B6; 

Port[$42] := 100; 

Port[$42] := 0; 

InPort61 := Port[$61]; 

Port[$61] := InPort61 or 3; 

Port[$61] := InPort61; 
end; 

Unfortunately, whenever any task subsequently calls 
sndPlaySoundO, the rest of the currently playing voice 
queue will become inaudible, though the old sound func¬ 
tions will continue to behave as if the queue were still 
progressing toward its end. (For instance, UaitSound- 
State(S_QUEUEEMPTY) will return at the time when the sound 
would have finished without the interruption.) A sub¬ 
sequent call to BeepEnableO will not rescue the old queue 
but will allow a new one to operate correctly, though one 
may (I'm not sure) need to call CloseSoundO before BeepEn¬ 
ableO and OpenSoundO afterwards. 

Larry Kuenning 
CIS: 70262,643 

A Thanks for pointing this out. I was overzeaious in as¬ 
serting that the old sound functions are no longer 
available. But the problem remains that the old sound, drv 
code is incompatible with the multimedia sound driver ar¬ 
chitecture. It is hard to imagine any commercial usefulness 
in adhering to the old sound API functions. 

Q ln reading your Q&A on waveform audio data in the 
September issue, I noticed some errors. Figure 2 in 
the September column details the format of a PCM RIFF 
file. The widths of four of the data elements are wrong. 
The entries wFormatTag, nChannels, nBlockAlign, and wBitsPer- 
Sample should be a word not a double word. 

If you take a look at any of the standard WAV files in 
hex mode with your favorite editor, you'll notice that the 
data chunk begins at offset 36 (decimal). Working back¬ 
wards, you'll see that those four fields should be words. (I 
have a copy of the Multimedia Programming Interface 
and Data Specifications 1.0 which lists the data widths for 
these entries. It can be found on CompuServe in the Win¬ 
dows Multimedia forum as rmtxt.zip or rmrtf.zip.) 


Listing 1 Revised code to create DOS box 


/******** *********************************************/ 
/* createvm.c */ 

/* -- Application demonstrates using Shell VxD */ 
/* protect mode API to create a hidden VH. */ 


#include <windows.h> 
#include <mmsystem.h> 
((include <stdlib.h> 
((include "shell.h" 


typedef DWORD (FAR * LPFN)(void); 


int PASCAL WinMain(HINSTANCE hins, HINSTANCE hinsPrev, 
LPSTR lpsz, int wShow) 


. tntry point. , 

/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ft*******************/ 


{ 

char szPath[128], szArg[128], szBuf[128], 
char *pch; 

DWORD tim = timeGetTimeO; 

LPFN lpfn; 

SEB seb; 

DWORD hvm; 


*pszCmd; 


/* Get Shell VxD’s protect mode entry point. */ 
_asm mov ax, 1684h; 

_asm mov bx, 0017h: 

_asm int 2fh; 

_asm mov word ptr [lpfn], di; 

_asm mov word ptr [lpfn + 2], es; 
if (NULL == lpfn) 
return 0; 


I* Check version number. */ 
_asm mov dx, 0; 
if (0x030a > (*lpfn)0) 
return 0; 


/* Initialize Shell Execute Data structure. */ 
seb.grfpif = fpifAltEnt I fpifAltPsc I fpifPrtSc I 
fpifCtlEsc I fpifAltTab I fpifAltEsc I 
fpifAHSp I fpifBack I fpifCloseE; 
seb.grfdis = 

0x00000010 I fdisEmText I fdisNoText | fdisNoLow; 

/* Obtain location of command interpreter. */ 
if (NULL == (pszCmd = getenvCCOMSPEC"))) 
pszCmd = "C: WDOSWCOMMAND. COM"; 
seb.wfpExe.ib = (WORD)pszCmd; 
seb.wfpExe.sel = SELECTOROF((LPVOID)pszCmd); 

/* Get working directory. */ 
for (pch = szPath + GetModuleFi1eNameChins, 
szPath, sizeof szPath) - 1; 
pch >= szPath; pch--) 
if (*pch == ’W) 

{ 

*pch = 0; 
break; 

} 

/* Create arg list for command.com. */ 
wsprintf(szArg + 1, 

"/c JsWdosbatch.bat one two three four", 
(LPSTR)szPath); 

szArg[0] = (char)(1 strl en(szArg + 1) + 2); 
seb.wfpArgs.ib = (WORD)szArg; 
seb.wfpArgs.sel = SELECTOROF((LPVOID)szArg); 

/* Special case if path is root. */ 
if (pch - szPath == 2) 

{ 

szPath[2] = ’\\’; 
szPath[3] = 0; 
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In summary, here are the true offsets (all offsets are 
decimal): 

(up to nChannels is correct) 

22 nChannels 
24 nSampIesPerSec 
28 nAvgBytesPerSec 
32 nBIockAlign 
34 wBitsPerSampIe 
36 'data' 

40 length 
44 audio samples 

Jerry Kelley 
CompuServe: 75027,2633 

A Aaaaagggggghhhhh! You are, of course, correct. That 
diagram is completely messed up. The correct dia¬ 
gram is contained in Figure 1. Thanks for pointing out the 
error. 

Q That was an interesting method for obtaining far 
pointers into a huge memory block [prb: 'Far Point¬ 
ers for Huge Memory,' in the Sept. '94 issue]. However, I 


think a simpler method would be to use the relatively 
well-documented interface of the winmem32.dll functions. It 
roughly works like this: 

1. Allocate a large block of memory (> 64Kb) using 
Global32Alloc(), which allocates the memory, and a 
16:32 selector. 

2. Using a long offset into the memory allocated and the 
selector returned above, obtain regular far pointers (< 
64Kb) using Globall6PointerAlloc(). 

I have used this interface extensively to manipulate 
large TIFF files and had no problems at all. 

Roger Samaan 
CIS: 74643,1402 

A My first reaction when I read your note was, 'oh no, 
why didn't I think of that?' But after attempting to 
convert the code sample from the article (contents, c in the 
original column) I am no longer so sure. 

There are two main problems. First is that Global32Al- 
loc() returns a selector to a USE32 segment. In general, 
you cannot pass this segment or any pointers based on it 
to any of the Windows API functions. The problem is that 
the processor treats stack switches differently between 


Listing 1 continued 


} 

seb.wfpWork.ib = (WORD)szPath; 
seb.wfpWork.se! = SELECTOROF((LPVOID)szPath); 


seb.cpagWant = 0xffff; 
seb.cpagMIn = 0xffff; 
seb.wForePriority = 100; 
seb.wBackPriority = 50; 
seb.ckbMaxEMS = 0x0400; 
seb.ckbMinEMS = 0x0000; 
seb.ckbMaxXMS = 0x4000; 
seb.ckbMinXMS = 0x0000; 
seb.wUnknownl = seb.wUnknown2 = 
Istrcpytseb.szTitle, "Demo VM”); 


/* Use default. 
/* Use default. 
/* 0 to 10,000. 
/* 0 to 10,000. 


*/ 

*/ 

*/ 

*/ 


/* Ask Shell to create the VM. */ 

_asm lea di, word ptr seb; 

_asm mov dx, 3; 

_asm push es; 

_asm push ss; 

_asm pop es: 

(*1pfn)(); 

_asm pop es; 

_asm _emit 66h; 

_asm mov WORD PTR hvm, ax; /* Really EAX. */ 
if (0 != hvm) 

{ 

wspri ntf(szBuf, 

"Created VM %lx, elapsed time Xld", 
hvm, timeGetTimeO - tim); 
MessageBoxtNULL, szBuf, "Hidden VM Demo", 
MB_0K); 

} 

return 0; 

} 

/* End of File */ 


Figure 1 Revised RIFF file diagram 
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USE16 to USE32 (or USE32 to USE!6) and USE! 6 to USE!6 into memory in one function call. You could reset 

(or USE32 to USE32) segments. The result is that the high the 'big' bit of the descriptor, but then you are 

16 bits of the ESP register can be lost. There could be po- back to using DPMI, as my example code does, 

tential problems switching control to 
WIN386 (the VxDS and Virtual Ma¬ 
chine Manager) and back to the Sys¬ 
tem Virtual Machine. The probability 
of this type of problem may seem 
small since the selector is being used 
as a data segment, and not as an ex¬ 
plicit stack segment, but Windows 
code is full of very bizarre code con¬ 
structs. Passing USE32-based pointers 
to Windows API functions makes me 
feel queasy. 

You might think, big deal, I can 
still allocate USEl 6, 16-bit selectors to 
reference up to 64Kb blocks from 
this USE32 segment. This is true, but 
there are cases where a >64Kb 
USEl 6 segment is genuinely useful. 

Specifically, some of the Windows 
API functions accept pointers to huge 
memory LhreadO, _hurite(), _hmem- 
cpy(), AnsiToOemO, etc.). These func¬ 
tions expect to receive a pointer into 
a huge USEl 6 segment. In fact, my 
demo application uses the _hread() 
function to read an entire text file 
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Shell Dynamic-Data Exchange Interface Overview (3.1) 


i^This topic describes the dynamic data exchange (DDE) interface of 
Windows Program Manager (PROGMAN.EXE). Program Manager is an 
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year from readers like you. You don't have to be a writer, but you 
do have to have a concrete topic of interest to other Windows 
programmers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. The easiest way to propose an 
article topic is to send email about your idea to the editor, Ron 
Burk, via CompuServe at 70302,2566 or Internet at 


Call for Papers 

70302.2566@compuserve.com. Make sure you include an esti¬ 
mate of the number of lines of code involved. 

If you don't have access to email, you can fax your proposal to: 
Managing Editor, Windows/DOS Developer’s Journal, (913) 841-2624, 
or mail it to: Managing Editor, Windows/DOS Developer’s Journal, 
1601 West 23rd St., Suite 200, Lawrence, KS 66046-2700. 
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Communications 

■ Proposals due 1 Dec 1994 
manuscripts due 13 Jan 1995 

Suggested topics: A look at Chi¬ 
cago’s support for serial communica¬ 
tions. Using VIM to add email support 
to your application. A simplified inter¬ 
face to TAPI functions. Code to spy 
on the serial port from Windows. 


Device Drivers 

■ Proposals due 1 Jan 1995 
manuscripts due 13 Feb 1995 
Suggested topics: An NT filter 
driver that tracks all open files. How 
VxDs have changed for Chicago. 
How to write a single mini-port driver 
to support both Chicago and NT. A 
generic NT port driver. How to load 
and unload NT and Chicago device 
drivers dynamically. 


Debugging 

■ Proposals due 4 Feb 1995 
manuscripts due 15 Mar 1995 
Suggested topics: How to take ad¬ 
vantage of Daytona’s new debugging 
API. A base C++ class for catching 
constructor/destructor bugs. Tips on 
which debugging tool to use for 
which problems. A test jig for debug¬ 
ging VxDs that expose APIs. A pro¬ 
gram that detects incorrectly installed 
OLE servers. 
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Changes 


TrackPopupMenu (3.0) 


<^BOOL TrackPopupMenu(A/77£?/?« fuFlags, x y, nResen.-'ed hwnd. Iprc ) 


Annotate 


Annotation: 


The documentation incorrectly states that you can pass the 
TPM_RIGHTBUTTON flag if you want the menu to respond to the right 
(secondary) mouse button instead of the left (primary) mouse button. In 
fact, passing TPM_RIGHTBUTTON causes the menu to respond to the 
right mouse button as well as the left. There is apparently no 
combination of bits that cause the menu to respond only to the right 
mouse button. 

[Add this annotation to your own online API help file by pressing Alt-E-A] 


Delete 


7 


The second problem is that uin- 
mem32.dll is not distributed with Win¬ 
dows. This means that if you are 
maintaining a commercial application 
you must go through the hassles of 
distributing Microsoft system-level 
software, with the inherent version¬ 
checking involved. 

Having said all that, I agree that 
using WINMEM32 does greatly sim¬ 
plify the implementation of my sam¬ 
ple application, so would likely be 
easier to use than the DPMI services 
presented in my article. This is still 
the case even if you resort to DPMI 
to change the selector returned from 
Global32Alloc() to a USE16 segment 
before calling a Windows API capa¬ 
ble of dealing with huge pointers. □ 
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Windows Developer’s Guide to Application 
Design 


Jeffrey D. Clark 

SAMS Publishing, 11711 N.College Ave., Carmel, IN 
ISBN: 0-672-B0239-X 

Price: $34.95 including a 3.5" examples disk 


Reviewed by Massimo Cesaro 


This book from Jeffrey D. Clark covers a topic which is 
becoming more important every day: Windows applica¬ 
tion design. In this context, the expression 'application de¬ 
sign' doesn't refer to the art of software engineering, but 
rather to the science of presenting information to the user. 

The Windows developers' community has widened 
considerably with the advent of visual development tools 
and languages. The power of these tools does not imply a 
correct use for them, especially when people are dealing 
with the organization of the user interface. The profes¬ 
sional developer cannot make the mistake of trying to en¬ 
force his or her vision of things: there is a de facto stand¬ 
ard which must be followed carefully to avoid the 'appli¬ 
cation weirdness' syndrome. Clark's book is based on his 
experience as a developer of commercial applications, and 
therefore contains some interesting real-word issues and 
the solutions adopted. 


Synopsis 

Chapter 1: Design Basics. After a handful of good advice 
(like 'know thy environment'), this chapter presents the 
anatomy of a Windows application. The focus is on win¬ 
dow styles and how or when to choose an overlapped vs. 
a popup window, and on the implications of the window 
style choice from the user perspective. At the end of the 
chapter is the ubiquitous HELLO.EXE, do-nothing program. 

Chapter 2: Menus. Although most Windows developers 
believe they cannot learn anything new about menus, this 
chapter is worth reading. It offers a discussion of drop¬ 
down and cascading menus, as well as of pop-up menus 
and standard menus (those menus which should always 
be present in your application). Owner-draw menus are 
presented as the implementation of the MRU (Most Re¬ 
cently Used) file list. The listing at the end of the chapter is 
for a demonstration of all the menuing techniques dis¬ 
cussed in the chapter. 


After working in C on UNIX minis and PCs for eight years, Massimo Cesaro has for the past four years developed Windows and OS/2 
applications. His interests included GUIs, scientific computing, real-time data acquisition and processing, networks, and object-oriented 
programming. He is currently a student in Pharmacy at the University of Padova. 






Chapter 3: Extended Window Styles. These are the 
styles introduced with Windows 3.1, such as US_EX_AC- 
CEPTFILES and US_EX_T0PM0ST. in effect, the core of the chap¬ 
ter is the drag-and-drop protocol of the Windows 3.1 
desktop, illustrated with a trashcan application which ac¬ 
cepts files through the drag'n'drop method just like the 
Mac. Interestingly, the author writes that he doesn't recall 
any application he has written or used that uses windows 
having the US_EX_ TRANSPARENT style. I have seen Windows 
applications ported from OS/2 which make use of trans¬ 
parent windows where the OS/2 application used 'object' 
windows (roughly equivalent) to capture mouse input. 


Chapter 4: User Input and Application Feedback. 

Chapter opens with a discussion of keyboard input. The 
concepts of mode keys, navigation keys, and accelerator 
keys are explained. For each group of keys, a table lists 
the standard keys and their expected meaning (e.g., 
Ctrl+F4 is "Close Document,' Ctrl-X is 'Cut'). The chapter 
then examines mouse input, covering single vs. multiple 
selections and mouse buttons usage. Clark divides applica¬ 
tion feedback into three groups: pointer feedback, i.e, 
changing the mouse cursor in response to events; audi¬ 
tory feedback, i.e., different tones in response to errors; 
and text feedback, i.e., the data provided through mes¬ 
sage boxes. The chapter ends with an application which 
demonstrates all the kinds of feed¬ 
back a user can get from a Windows 
program. 

Chapter 5: Dialog Boxes. This is 
fundamental: most of the time the 
user interacts with a dialog box of 
one form or another. The chapter 
opens with a brief description, includ¬ 
ing a discussion of usage, of each of 
the standard controls Windows gives 
to the developer. Next comes a treat¬ 
ment of the Common Dialog Boxes 
and their plug-and-play philosophy, 
in the course of which the author de¬ 
velops a custom common dialog box 
DLL. The chapter presents some 
guidelines for the implementation of 
modal and modeless dialog boxes. 
Particularly interesting here is a figure 
illustrating the dialog box spectrum. 
At one end the author puts applica¬ 
tion modeless dialog boxes, labeling 
them 'Freedom'; at the other end are 
the system modal dialog boxes, la¬ 
beled 'Oppression.' I'm still trying to 
figuring out how Clark would have 
labeled the two classes in between! 

Chapter 6: Status Bars, Icon Bars, 
and Tool Boxes. Today no Win¬ 
dows application can be considered 
finished without a status bar, and 
icon bars and tool bars are a plus. 
Clark explains how to implement all 
of these without writing tons of code. 
His discussion goes into detail, to the 
point of explaining which pattern to 
use to achieve a 3-D chiseled-steel 
look for your application compo¬ 
nents. The example program pro¬ 
vides all of the elements discussed. 

Chapter 7: Owner Draw and Custom 
Controls. Yes, there are rules even for 
the implementation of new controls, 
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and in this chapter there are guidelines for the owner- 
draw behavior of listboxes and comboboxes. Here Clark 
describes how to build a progress bar custom control like 
those used in most setup programs. The application pro¬ 
vided at the end of the chapter makes full use of owner- 
draw controls and the progress bar. Also included is full 
source code for the custom control as a DLL interfaced to 
the ancient Microsoft dialog editor DLGEDIT. 

Chapter 8: Multiple Document Interface Applications. 

This chapter consists mainly of a discussion of the MDI 
protocol; the main question here is whether your applica¬ 
tion needs this interface. Clark defines MDI behavior by 
observing Microsoft Excel, but provides little that is new. 
The chapter ends with full source code for a basic MDI 
application similar to those that come with your develop¬ 
ment system samples. 

Chapter 9: Object Linking and Embedding. If you don't 
know what OLE is, this chapter is for you. It presents a 
synthesis of the OLE (version 1) protocol and its imple¬ 
mentation based on DDE. Again, the perspective is the 
user's, so much of the detail is devoted to an explanation 
of how a good OLE client and OLE server should behave. 
There is a peek at the new OLE 2 definition, but no code 
here. (Incidentally, the author has also published a book 
entitled Windows Programmers' Guide to OLE/DDE, which 
should be filled with example code on the subject.) 


Chapter 10: Database and File Access. This is another 
'all theory, no code' chapter. In it Clark discusses the 
guidelines for implementing database access from a Win¬ 
dows application. The text is short and easy to read, and 
some of the ideas could prove interesting, but there isn't 
even a figure to support the argument. 

Chapter 11: Help Systems. Help is a topic that must be 
considered seriously. While big corporations can afford to 
hire professional writers and visual designers to prepare 
help systems, in small shops the programmer or the group 
must handle everything, from coding to documentation to 
help. Clark presents a short introduction to the Windows 
help system, covering the organization of help source files 
and help coding. Although an application with context- 
sensitive help is provided at the end of the chapter, over¬ 
all Clark's treatment of the subject makes one thing clear: 
developing help is just as difficult as programming. So if 
you've invested time and money in books on Windows 
programming, be prepared to do the same in books on 
Windows help development. You owe it to your custom¬ 
ers and to yourself. 

Chapter 12: Application Installation. Another thorny 
topic. You can solve it in one of two ways: buy someone 
else's toolkit or write your own. For the latter case, Clark's 
advice is really useful. While keeping the description con¬ 
cise and the code short, he presents a complete (well, al¬ 
most) install utility that can be used right out of the book. 
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There is good coverage of the decompressing library, 
LZEXPAND, but I found notable the omission from this 
book of a discussion of the version control library, VER. In 
any case, I found this chapter the most interesting in the 
book. 

Chapter 13: Total Design. In this chapter the author ap¬ 
plies all of the concepts of the book to show you how to 
design a real-world application. Unfortunately, the exam¬ 
ple chosen is the same old(!) MDI editor. It would be nice 
if the application had been something different, as, for ex¬ 
ample, a small graphic editor. 

Chapter 14: Application Planning. In the final chapter 
Clark warns readers about the fast-changing world of Win¬ 
dows development. Windows NT, with its brand-new ar¬ 
chitecture, is a challenge for the developer, but here the 
author simply lists some of the most innovative concepts 
of NT and its cousin, Win32. I think that in five or six 
small pages it would be difficult to write an ad for NT, let 
alone a technical brief. 

Comments 

The back cover of the book claims that 'this book is 
written just for people involved in Windows application 
development - from programmers to non-programmers." 
Well, this may be the intent, but I think that only pro¬ 
grammers can really understand what is written inside. 


Lillie Big Lon 
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The book comes with a 3.5" disk containing all the ex¬ 
amples. There are versions for ANSI C compilers, for the 
Borland C++ compiler and OWL library, and for the Mi¬ 
crosoft C++ compiler and MFC 1.0 library; ail the exam¬ 
ples listed in the book are for the latter combination. I 
think that guidelines in Windows application design are 
needed from the development community: from the days 
of the first CUA (Common User Access) draft document it 
was clear that a complex GUI like Windows could be a 
user's dream or a nightmare if applications don't agree on 
common rules. Technical magazines recognized this, and 
sensible magazines like W/DDJ already feature articles like 
the 'Visual Implementation' series, which help to enforce 
a standard. Jeffrey Clark's work is based on real-life expe¬ 
rience and is therefore worthy of respect (it is also much 
more friendly than IBM's official documents on CUA!). Al¬ 
though I cannot say I consider this book indispensable, I 
must acknowledge that some of its ideas helped me dur¬ 
ing application design stages. The book is well presented 
- I didn't noticed even a typo, and the overall graphics 
are fine. 

The book does have some weak points, however. One, 
unavoidably, is its obsolescence due to the new frame¬ 
works from Borland and Microsoft, which give the devel¬ 
oper every element discussed in the book as a class ready 
to use. With these frameworks, topics like status bars, 
toolboxes, and MDI applications are just a click away, no 
questions asked. There are even controls that transform 
an application into an OLE 2 server or client and that 
automatically handle database access, providing tables 
and an indexed browser without the developer's having to 
write a line of code. Clark's book offers a rationale for all 
of these features, but time flies. 

In the back cover of the book, there is a seal of techni¬ 
cal accuracy. However, I ran some of the examples with 
the run-time memory-checking features of MFC 2 active. 
My debugging terminal showed some memory leaks in 
the programming examples, especially in the install utility. 

But there is something that I cannot forgive: the front 
cover (an illustration inspired by an M.C. Escher drawing) 
claims that the book 'Covers Win32s and Windows NT' 
and 'Includes the coverage of OLE 2.O.' First, the OLE 2.0 
is merely cited, and though the back cover asserts that 
there are 'Examples of OLE 2.0 applications' inside, I was 
not able to find any. I don't look for a thousand pages 
like the Brockschmidt bible on the subject, but the few 
pages of description and figures in the book do not consti¬ 
tute coverage of OLE 2.0. Second, calling the six pages of 
chapter 14 coverage of NT and Win32s is at minimum 
dubious. The book can be sold without those two chap¬ 
ters or, alternatively, without misleading marketing hype 
on the covers. I think that at $34.95, it's a question of 
budget, but the book is worth reading, or at least perus¬ 
ing, one time. □ 
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Industry-Related News & Announcements 


New Toolkit Aids Windows MIDI Developers 


The MIDI Programmer's Toolkit for Windows is a 
new DLL from Music Quest designed to help Windows 
programmers develop music programs (sequencing pro¬ 
grams, music notation programs, etc.) to work with MIDI 
instruments and sound cards. You can use the DLL to 
read and write standard MIDI files, receive and transmit 
MIDI events to/from MIDI instruments and sound cards, 
filter the events as required, and synchronize to an inter¬ 
nal timebase, MIDI clock, or SMPTE time code. 


The MIDI Programmer’s Toolkit for Windows costs 
$99.95, and includes full source code, a 68-page refer¬ 
ence manual, and two example programs. For more in¬ 
formation, contact Music Quest, 7700 Alma Drive, Suite 
330, Plano, TX 75075, (274)887-7408; 
fax (274) 422-7094. 


MetaWare C/C++ Compiler for NT Ships 

MetaWare is now shipping its High C/C++ compiler 
for Windows NT. The new compiler is compatible with 
Microsoft's 32-bit SDK, producing standard COFF object 
modules and debugging information compatible with 
Windbg and Visual C++ debuggers. The compiler in¬ 
cludes an 'EasyDLL' feature that lets you flip a switch to 
export or import functions in a block of code. An 
'EasyThread' facility gives you stackable toggles to turn 


on and off sections of code that use thread-local storage. 
A Win32s enablement package allows 32-bit applica¬ 
tions built with this compiler to run under Windows 3.1. 

High C/C++ v3.2 for Windows NT costs $595. Current 
users of High C/C++ can buy it for $495. For more infor¬ 
mation, contact MetaWare Inc, 2767 Delaware Avenue, 
Santa Cruz, CA 95060-5706, {408) 429-6382; 
fax {408) 429-9273. 


XVT Ships New Visual Programming Tool 


The new release (v3.0) of XVTs Development Solu¬ 
tion for C++ includes a new visual programming tool 
(XVT-Architect) and new features in the XVT-Power++ ap¬ 
plication framework. The XVT tool set is aimed at help¬ 
ing you create applications that are implicitly portable 
across multiple operating systems, such as Windows, NT, 
OS/2, the Macintosh, OSF/Motif, and so on. 

XVT-Architect is a graphical tool for developing port¬ 
able C++ applications. It provides point-and-dick interac¬ 
tion with the XVT-Power++ application framework, and 
consists of three modules: Blueprint, Drafting Board, and 
Object Strata. The Blueprint module lets you browse the 
object hierarchy and see the structure of the application 
and the messaging relationship among objects. The 
Drafting Board module is a graphical layout tool for de¬ 
signing windows, menus, strings, and other visual frame¬ 
work objects. This module offers geometry management 
(for automatically adapting to different monitor resolu¬ 
tions), and the ability to lay out and set attributes of XVT- 


PowerObjects. The Object Strata module lets you view 
the inheritance of an object; you can set data members 
and directly access inherited data members. 

The XVT-Power++ 3.0 application framework in¬ 
cludes three new tools for portable runtime resources. 
Portable Images lets you design bitmapped images for 
toolbars, palettes, etc., that can be used on all platforms. 
Portable Native Font Access provides a cross-platform 
font-mapping mechanism, giving users access to font se¬ 
lection through the native system resources. A new Port¬ 
able Hypertext Help System lets you maintain one set of 
source material for help text used on all target platforms. 
The new help system uses either the native help viewer 
of the platform or the portable XVT help viewer. 

XVT's Development Solution for C++ v3.0 is licensed 
on a developer-seat basis at $1,950 on personal comput¬ 
ers and $6,300 on workstations. For more information, 
contact XVT Software Inc, 4900 Pearl East Clrde, Boulder, 
CO 80307, (303) 443-4223;fax (303) 443-0969. 
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EMS Updates C/C++ and Assembly Language Libraries 


EMS Professional Shareware has updated two of its 
large software collections aimed at professional program¬ 
mers. 

The C/C++ Utility Library has more than 100 new 
products for a total of 1,502 public domain and share¬ 
ware products, most with source code. Categories of soft¬ 
ware include arrays, benchmarking, binary trees, 
translation, TSRs, and more. The ASM Utility Library now 
includes 503 public domain and shareware products for 
professional assembly language programmers. Catego¬ 
ries of files include benchmarking code, BIOS, communi¬ 
cations, compression debugging, disassembling, disk I/O, 


graphics, math, memory management, multitasking, se¬ 
curity, sound, video, and more. 

Both libraries come with an indexed database to help 
you locate files of interest via multiple criteria. The 
C/C++ Utility Library costs $59.50 on CD-ROM or $149 
on 85 diskettes; a subset containing 671 files just for 
C++ on 47 diskettes is $99.50. The ASM Utility Library 
costs $59.50 on CD-ROM or 15 diskettes. For more infor¬ 
mation, contact EMS Professional Shareware, 4505 
Buckhurst Ct, Olney, MD 20832-1830, (301) 924-3594; 
fax (301) 963-2708; Internet: eengelmann@wortdbank.org. 


Class Library Brings DDE Support to MFC 


Resource Concepts, Inc., is shipping a C++ class li¬ 
brary that integrates DDE management into the Mi¬ 
crosoft Foundation Classes (MFC) library. Two classes, 
CDdeManager and CDdeltem, give your MFC program si¬ 
multaneous client/server DDE functionality under Win¬ 
dows 3.1. Network DDE is supported through Microsoft's 
Windows for Workgroups Resource Kit DDESHARE pro¬ 
gram. The CDdeManager class manages communica¬ 
tions with the DDEML DLL, while subclasses of CDdeltem 


provide concurrent client/server capability for the follow¬ 
ing data types: floats, doubles, integers, longs, char or 
byte data of any type, Cstring objects, and any MFC COb- 
ject that supports serialization. 

The CDdeManager and CDdeltem classes cost $149, 
are royalty free, and include source code. For more infor¬ 
mation, contact Resource Concepts, Inc, 111 W. First 
Street, Suite 748, Dayton, OH 45402, (513) 461-4606; 
fax (513) 461-7908. 


Embed PCL Files in Your Application 

Visual Forms is a new tool that lets you create com¬ 
plex forms in PCL (Printer Control Language) format 
(used by HP and compatible printers) that you can then 
embed in your DOS or Windows application. Any applica¬ 
tion that can send a macro to the printer (FoxPro, Clip¬ 
per, Clarion, BASIC, C/C++, etc.) can include these forms 
and print them (the Windows version comes as a DLL). 
You can interactively draw the form by dragging and 
dropping objects with the mouse. The designer gives you 


the ability to paste graphics in directly, save sections of a 
form to later merge with a main form, embed fonts or 
macro Ids into the PCL file, align multiple objects, and 
more. Visual Forms comes with six typeset fonts and sup¬ 
ports only PCL fonts. 

Visual Forms costs $249. For more information, con¬ 
tact Bytech Business Systems, Inc, 5C Medical Park, 
Pomona, NY 10970, (914) 354-8666; 

CompuServe 74577,1032. 


WCSC Creates New Serial Port Drivers for DOS and Windows 


WCSC has released three new communications driv¬ 
ers for DOS, Windows, and DESQview. 

COMM-DRV/WIN replaces the standard Windows 3.x 
serial port driver to allow any number of serial ports to 
be accessed via the Windows API. It gives existing Win¬ 
dows communications applications the ability to access 
non-standard multiport serial cards. COMM-DRV/DOS is 
a TSR/device driver that lets programs read or write the 
serial port as though it were a file. It provides both the 
FOSSIL interface and the INT14H interface. Both COMM- 
DRV/WIN and COMM-DRV/DOS support standard COM! 
and COM2 ports, as well as intelligent multiport cards 


(Amet, Digiboard, etc.), and all non-intelligent multiport 
cards. All ports can be active concurrently. COMM- 
DRV/VxD is a Windows VxD designed to get the best per¬ 
formance from whatever UART your machine has. It has 
a custom DLL interface, callable by any language that 
can make DLL calls. 

COMM-DRV/WIN, COMM-DRV/VxD, and COMM- 
DRV/DOS each cost $99.95. For more information, con¬ 
tact WCSQ 2470 & Dairy Ashford, Suite 188, Houston, TX 
77077, (800) 966-4832 or (713) 498-4832; 
fax (713) 568-3334. 


Genus Graphics Toolkits Get PowerBASIC Support 


Genus Microprogramming has added PowerBASIC 
support to its line of graphics programming toolkits, the 
GX Development Series. The DOS toolkits let program¬ 
mers add graphics support, imaging, special effects, ani¬ 
mation, sound, and printer support to their PowerBASIC 
programs. The toolkits include GX Graphics, GX Text, GX 
Effects, GX Printer, PCX Toolkit, and GIF Toolkit. All the 


toolkits are written in assembly language and support 
graphics modes from CGA and Hercules up through 
SVGA 1280x1024 in 16 million colors. 

For more information, contact Genus Microprogram¬ 
ming, Inc, 1155 Dairy Ashford, Suite 200, Houston, TX 
77079, (800) 227-0918 or (713) 870-0737. 
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Zinc Updates Application Framework 

Zinc has released version 4.0 of the Zinc Application 
Framework, an object-oriented, cross-platform library for 
building portable applications. This version features ge¬ 
ometry management, drag-and-drop support, printing 
support, and table, notebook, and status bar controls. In¬ 
ternational features in this version include support for 
both single-byte (ISO) and double-byte (Unicode) charac¬ 
ter sets. The library also provides default string transla¬ 
tions for more than twelve languages and support for 18 
locales. A new visual design tool is designed to be exten¬ 
sible by developers. This version adds support for Chi¬ 


cago, Power Macintosh, DESQview/X, QNX, and 
NEXTSTEP. 

Zinc Application Framework v4.0 consists of the Zinc 
Engines, and at least one key. The Zinc Engine costs 
$499; keys range from $299 for the DOS, Windows, 
OS/2, or Apple Macintosh key to $4,999 for the Unicode 
Key. For more information, contact Zinc Software Inc, 
405 South 100 East 2nd Floor, Pleasant Grove, UT 
84062, (801) 785-8900;fax (801) 785-8996; 

BBS (801) 785-8997. 


Multi-Platform Simulation Toolkit Cains Synchronicity 


CSIM 17 is a new version of CS1M, a package that 
uses C and C++ to build simulation modules on a variety 
of platforms such as UNIX, Windows, and the Macintosh. 
CSIM has been used to model complex systems such as 
a multiprocessor DBMS, computer networks, a coherent 
cache-bus-memory subsystem, and so on. New features 
include moving window averages and random number 
streams. This version offers synchronous facilities and 


storages for modeling components that operate in a 
clocked manner. Timed operations allow users to model 
requests for resources where the request has a time limit. 

The basic CSIM package costs about $500 and in¬ 
cludes a revised Users's Guide. For more information, 
contact Mesquite Software, Inc, 8920 Business Park 
Drive, Austin, TX 78759, (512) 338-9153; 
fax (512) 794-9997. 


CodeLock vl.5 Tackles Software Piracy 

CodeLock vl .5 is the latest version of a software 
product designed to provide copy protection for Win¬ 
dows developers. Users register their software by using 
telecommunications to obtain a unique authorization 
code from the software developer. CodeLock vl .5 offers 
three kinds of locking. The program lock prevents soft¬ 
ware from being copied to another machine. The time 
lock sets the number of days the software will run. The 
counter lock places a limit on the number of times the 
software can be run. The product can determine if the 


software has been copied to another machine or if the 
system clock has been tampered with. Registered users 
can reorganize software on their system without break¬ 
ing the locks. Optimizing and system backup will not de¬ 
stroy the locks. 

CodeLock vl .5 (a DLL) costs $399 for up to 250 total 
registered users, $699 for up to 1,000 users. For more in¬ 
formation, contact Robust Software, 2345 Janln Way, 
Solvang, CA 93463, (805) 688-6312. 


New VBXs Enhance Document Viewing/Printing 


VSView is a new set of four custom controls for Vis¬ 
ual Basic. The interface consists of 'visual printers,' vis¬ 
ible on the desktop, where users can use the same code 
to print and preview multi-page documents. Interface fea¬ 
tures include zooming and panning file drag-and-drop, 
and formatting options such as headers, footers, graph¬ 
ics, tables, and multi-column output. Printing with 
VSView is like controlling a word processor programmati¬ 
cally; you can create output by words, lines, paragraphs, 
tables, or columns. 

Other VSView controls let programmers customize 
the look and feel of forms and other controls. You can 


make controls look and behave like forms so they can 
be moved, resized, or have custom buttons with pictures. 
A Drawing control is used to create complex images 
such as technical drawings and maps. The images can 
be viewed on the screen, printed, or copied to the clip¬ 
board. A Viewport control provides virtual, scrollable ar¬ 
eas that extend beyond the physical screen. 

VSView costs $99. For more information, contact 
VldeoSoft 2825 Alcatraz Avenue, Suite 271, Berkeley, CA 
94705, (510) 547-7295;fax (510) 547-1084. 


Testing Software Adds Scripting Language, Mouse Support 


Vermont Software has released a major upgrade to 
Its automated testing tool for DOS, Vermont Test v2.0. 
The new version provides full mouse support, a scripting 
language, single-step playback enhancements, more re¬ 
cord and playback options, and support for additional 
video modes. The new scripting language allows for test 


customization, such as executing scripts in a loop, calling 
subscripts, and DOS file operations. 

Vermont Test v2.0 costs $395, which includes a 60- 
day, money-back guarantee. For more information, con¬ 
tact Vermont Creative Software, 1 Pinnacle Meadows, 
Rlchford, VT 05476, (802) 848-7731;fax (802) 848-3502. 
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LiantAdds OLTP Support to Open PL/I 

Liant Software Corporation has shipped a new ver¬ 
sion of its PL7I development framework. The new ver¬ 
sion integrates with Transarc's Encina open transaction 
processing environment to migrate PM-based online 
transaction processing applications from mainframe to 
UNIX environments. Users can select at compile time 
one of three file management systems for VSAM sup¬ 
port: C-ISAM (Informix), Transarc's Structured File Server, 
or Open Data Access (Liant's file system). The package 


now supports Liant's C++/Vlews and C-scape products, al¬ 
lowing programmers to use those tools in constructing 
graphical user interfaces for their applications. This re¬ 
lease also includes the most commonly used DEC VAX 
VMS PL/I extensions. 

Open PL/I v6.0 for Windows NT costs $20,000 for an 
eight-user system. For more information, contact Liant 
Software Corporation, 959 Concord Street, Framingham, 
MA 01701-4613. (508) 872-8700;fax (508) 626-2221. 


Xbase DOS Networking Library Moves to Windows 


Pinnacle Publishing has created a Windows version 
of NetLib, their networking library for FoxPro program¬ 
mers. NetLib for FoxPro/Windows Is identical to its DOS 
counterpart, allowing programmers to use the same 
code to access it on both platforms. A new Assembler 
API provides register-level functions that let users create 
their own networking functions to perform tasks unique 
to a given application. The library provides encryption 
for data security, control over the network environment 
and bindery layer, and advanced locking functions, in¬ 


cluding semaphore locks, "who has if queries, and a 
timeout function. 

NetLib for FoxPro/Windows costs $299 (includes 400- 
page manual) and requires FoxPro for Windows v2.5 or 
later. Users of NetLib for FoxPro/DOS v2.0 can upgrade 
to the Windows version for $179. The company also 
sells NetLib for CA-Clipper for $299. For more informa¬ 
tion, contact Pinnacle Publishing, 18000 72nd Ave 5, 
Suite 217, Kent, WA 98032, (800) 788-1900 or 
(206) 251-1900; fax (206) 251-5057. 


Access Softek Windows Plug-Ins Now Available Retail 


Access Softek has announced a new product line for 
software developers: Plug-In components for Windows, a 
set of DLLs and VBXs that you can snap into Windows 
applications to add functionality. 

The Plug-In Document Editor provides WYSIWYG 
document processing. It reads and writes RTF files and 
supports text, graphics, and embedded objects. Installing 
with three function calls, the editor offers a user interface 
that includes a graphical ruler, button, control and status 
bar, tabular columns and tables, and support for printing 
and graphics Import. P.l. Text Import/Export Filters im¬ 
port and export DOS and Windows Microsoft Word and 


WordPerfect files. P.l. Bitmap Import Filter imports TIFF, 
PCX, GIF, BMP and EPS (preview) formats. P.l. Vector Im¬ 
port Filters offer the same service for vector file formats, 
including DXF, CDR, CGM, EPS Postscript, WPG, WMF, 
GEM, Lotus PIC, HPGL, and DRW. 

Plug-In Document Editor costs $995, P.l. Text Im¬ 
port/Export Filters costs $995, P.l. Bitmap Import Filter 
costs $395, P.l. Vector Import Filters costs $695 per for¬ 
mat. For more information, contact Access Softek, 2550 
9th Street *206, Berkeley, CA 94710, (510) 848-0606; 
fax (510) 848-0608; CompuServe 76702,776; 

Internet: pluglns@spftek.com. 


SourceSafe Version Control Adds Security and Merging 


One Tree Software has produced a major upgrade to 
its multi-platform version control system. As with pre¬ 
vious versions, SourceSafe v3.0 provides 'project-ori¬ 
ented' source code control, allowing you to organize the 
version database as a hierarchical tree of projects, and 
giving you the ability to use code from one subproject in 
more than one other project (changes are propagated to 
all projects that share the common code). 

The new version features project-based security. User 
access rights propagate down the project tree, like direc¬ 
tory rights in a UNIX system. The administrator can desig¬ 
nate up to five levels of privileges per user for each 


project or sub-project. A new three-way merge facility 
lets multiple SourceSafe users work in parallel on the 
same file or project. As each user checks in the file, Sour¬ 
ceSafe automatically merges the file with the current ver¬ 
sion, flagging any conflicting changes. A new visual 
differencing features gives you a color-coded compari¬ 
son of two files so you can see what was changed. 

SourceSafe v3.0 costs $295 for a single-user, Win¬ 
dows-only license. For more information, contact One 
Tree Software, P.O. Box 11639, Raleigh, NC27604, 

(919)821 -2300; fax (919)821-5222; CompuServe 
72662,744. 


Display/Print/Scan Images with T-BASEfor Windows 


T-BASE for Windows vl .0 is a new imaging library for 
Windows developers. T-BASE for Windows lets you add 
pictures and document images to any Windows applica¬ 
tion and Is compatible with FoxPro for Windows, Visual 
Basic, Visual C++, or any environment that can call DLLs. 
The package supports the following image file formats: 
JPEG, PCX, TGA, DCX, GIF, BMP, DIB, and TIF (including 


Group lll/IV). The library offers functions for displaying, 
printing, and scanning images as well. 

T-BASE for Windows costs $495. Users can upgrade 
from T-BASE DOS for $195 or buy the DOS/Windows 
bundle of T-BASE for $595. For more information, con¬ 
tact Videotex Systems, Inc, 11880 Greenville Ave., Suite 
100, Dallas, TX 75243, (800) 888-4336 or (214) 231-9200; 
fax (214) 231-2420. 

(continued on page 82) 
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Bug++ of the Month 

Mark Nelson 


I've been getting a lot of mileage from the problems 
the current generation of C++ compilers is having with 
constructors and destructors. As I've noted before, com¬ 
piler writers have gotten pretty good at generating C code, 
but some of the new features in C++ remain a little slip¬ 
pery. Object creation and destruction seem to be prone to 
mistakes. 

This month's bug shows up when Visual C++ con¬ 
structs arrays of objects. bug@08.cpp (Listing 1) shows some 
sample code that displays the problem. The program de¬ 
fines a very simple class, foo, that has a single constructor 
and no other members. The constructor increments a 
global counter so I can keep track of how often it is 
called. 

When compiled with optimization turned off, bug@98.exe 
behaves normally. The constructor for class foo gets called 
five times, just as you would expect. But when you recom¬ 
pile the program with optimization turned on ('/Ox' on 


the command line), the constructor for foo gets called 834 
times! 

I thought it would be interesting to see if I was really 
getting 834 separate foo objects, so I overloaded the 
global new operator. That way I would be able to see how 
many bytes the compiler requested. The final version of 
bug@08. cpp generated this output: 

Now in main, size of foo is 1 
Constructing an array with 5 objects 
New requesting 3192 bytes 
Constructor was called 834 times 

I'm still not exactly sure what the compiler is doing here, 
but clearly it is not what the designers intendedl It should 
be calling the constructor five times, and asking for some¬ 
where around five bytes. What is happening here is any¬ 
one's guess. 


Mark Nelson is a programmer for Creenleaf Software and a student at the University of Texas at Dallas. Mark is the author of The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from MBT Books. You can reach Mark 
on CompuServe at 73650,312. 
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Listing 1 A wild bug in Visual C++ v1.5’s optimizer 


/* 

* BUG008.CPP. 

★ 

* When compiled with optimization turned on 

* (CL /Ox bug008.cpp /LINK /NOE). 

* this program demonstrates a bug In array allocation 

* for the Microsoft C++ 8.0 compiler. 

* 

* When compiled and run with n = 5, this program 

* requests 3875 bytes from global new, when It should 

* need 5 or perhaps a few more. The constructor Is called 

* 834 times, when It should be called just 5 times. 

* 

*/ 

//include <1ostream.h> 

//Include <stdlib.h> 

//include <std1o.h> 

1nt inmaln * 0; 

Int ctor_calls = 0; 

void * operator new( size_t size ) 

{ 

if ( inmaln ) 

prlntf( "New requesting %d bytes\n", size ); 
return mal1oc( size ); 

} 

void operator delete! void *p ) 

{ 

If ( p ) 


“I want to live.” 


Ashley has cancer. It 
sounds like such a grown¬ 
up disease. But each year, 
more than 6,000 American 
children will be stricken 
with cancer. 

Ashley, and thousands of 
others like her, will have a 
chance to beat cancer 
because of the research and 
treatments developed at St. 
Jude Children’s Research 
Hospital. 

The scientists and 
doctors at St. Jude Hospital 
will keep fighting childhood 
cancer until every child can 
be saved. 

This life-saving research 
at St. Jude is made possible 
by public contributions. 

To find out more, call 

1-800-877-5833. 

ST. JUDE CHILDREN'S 
RESEARCH HOSPITAL 

KA# Danny Thomas. Founder 
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Microsoft's Response 

Steve Ross from Microsoft had a few comments about 
this bug. Most important, Steve said: 

You have isolated a bug in the C8.00c compiler when full 
optimizations are turned on. We are aware of this bug, and 
you'll find that it in Visual C++ 2.0, the problem is fixed. 

Steve also points out the workarounds for this problem, 
the most useful one being to disable optimizations for the 
affected section of code. 

Say Goodbye to a Dead Horse 

If you have been following this column since its incep¬ 
tion a few months ago, you should now have a healthy 
distrust of your compiler's ability to properly generate con¬ 
structors and destructors for objects. This doesn't mean 
you need to drop C++ and go back to C, or assembly 
language. All it means is that you shouldn't be afraid to 
double-check code that others might take for granted. 

Next month I will start looking at some other problem 
areas for compilers, including code generation and run 
time library bugs. If you have any interesting problem re¬ 
ports in these or other areas, please feel free to mail them 
to wdletter@rdpub.com. If we use your bug in a column, you 
will get a one-of-a-kind W/DDJ t-shirt, not to mention a 
brief moment in the limelight! □ 


Listing 1 continued 


freet p ); 

} 

class foo { 
public : 

foo(){ ctor_cal1s++; }; 

}; 

malnO 

{ 

1nt n = 5: 

Inmaln = 1; 

prlntft "Now In main, size of foo is M\n", sizeof( foo ) ); 
prlntft "Constructing an array with %d objects\n", n ); 
foo* array = new foo[ n ]; 

prlntft "Constructor was called %i tlmestn", ctor_calls ); 
return 0; 

} 

// End of File 


winPAK - The C++ Custom Controls 


Finally there are controls created expressly for Windows C++ 
programmers. winPAK unleashes the full power of C++. winPAK controls 
are FAST! winPAK is compatible with Borland C++, Visual C++ and 
Symantec C++. Borland C++ programmers even get access to the winPAK 
internals, can derive their own new classes from winPAK, and override 
internal features. Try that with a VBX control! winPAK is a single DLL that is 
fully compatible with Borland Resource Workshop. Look at winPAK’s 
impressive lineup: 


A Full-Featured Spreadsheet 



Part No. 

Description 

Unit Price 

1 

PCL-2-50 

* 2 Pencils 

4.95 

2 

ERS-1-12 

Pencil eraser 

2.25 

3 

PAPWHT-8 

White Paper 

1.99 

4 

MSPAD-1 

Mouse Pad 

0.75 

5 

PEN-3-10 

Black pen 

2.49 

6 

STPL-3 

Office stapler 

2.35 


BUHU-UL 


ZZ^ZL 


1- It’s a spreadsheet! Connect 
cells together with expressions. 

2- It’s a grid! Connect it to any 
ODBC-compliant database, 
without any need to code! 

3 - It’s a virtual listbox! Up to 2 
billion items. 

Use the mouse at runtime to change 

cell, column or row properties. 


Bitmaps galore: in radiobuttons, 
checkboxes and listboxes. Use 
our winPAK controls as direct 
replacements for the standard 
controls. Use the hierarchical 
listbox for outlines and trees. Full 
horizontal scrolling is supported 
automatically. 


Bitmapped Windows Controls 
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Instrumentation Controls 



winPAK has all kinds of controls for 
analog variables: faders, gauges, 
completion status bars, knobs. 
winPAK has the best looking 
controls in the business. winPAK 
gives you full control over how each 
item looks on the screen, with little 
or no coding necessary! 


winPAK has everything for data 
entry. Let winPAK check characters 
and do range checking or data 
conversion for you. winPAK handles 
strings, picture-template strings, 
integers and floating point numbers. 
winPAK’s error reporting is 
unsurpassed! 


Validated Data Entry 


—i Validated Edit Controls 



Properties, Properties ! 



All winPAK controls are compatible 
with Resource Workshop. Each 
control has its own set of detailed 
and easy-to-use property sheets, to 
let you tune each control with 
immediate feedback. Certain 
controls even have a proprietary 
Integrated Designer. 


Little or no coding needed - Just add winPAK controls to your resource file, 
and we take it from there. Properties are usually established under 
Resource Workshop, but runtime changes can also be made. 


winPAK comes with 19 bullet proof controls - We even make the 
source code available! So what are you waiting for ? Call our order desk at 
(800) 500-6535 to order! winPAK is priced at only $249.95. winPAK with 
source code is $499.95. VISA or MasterCard accepted. Fax your order to 
(714) 854-6459, or use CompuServe at 76350, 1013. Call for a free demo 
disk. winPAK comes with a 30 day money-back guarantee. No royalties. 


faison 0 

comput ing 


4199 Campus Dr. # 550 Irvine, CA 92715 
Tel (714) 854-6535 Fax (714) 854-6459 


□ Request Reader Service #104 □ 
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(continued from page 78) 


WindowsMAKER Update Features New Project Manager 


Blue Sky Software is shipping the latest version of 
their GUI development tool, WindowsMAKER v6.0. A 
new, configurable project manager lets you access win¬ 
dows, dialog boxes, toolbars, icons, cursors, bitmaps, and 
source code from a central place. Three new floating pal¬ 
ettes are included: the Toolbox lets you drag and drop 
new resources and controls; the Property Sheet lets you 
access any control and set its styles and event options; 
and the Color and Font Palette lets you set colors and 
fonts for any control from a single place. This version 


provides support for VBX controls from third-party ven¬ 
dors. 

WindowsMAKER v6.0 has an introductory price of 
$495, which includes the three Switch-lt code generation 
modules; the normal price is $995, and upgrades from 
the previous version cost $199. For more information, 
contact Blue Sky Software Corporation, 7486 La Jolla 
Blvd., Suite 3, La Jolla, CA 92037, (800) 677-4946 or 
(619) 459-6365; fax (619) 459-6366. 


Updated Bug Tracker Gains Graphing and Workgroup Controls 


Track Record vl .5 is the latest version of Under- 
Ware's information tracking tool for Windows program¬ 
mers. Track Record helps a programming team keep 
track of ongoing work on a project: bugs to be fixed, pro¬ 
gram sections to be documented, technical support is¬ 
sues, relationships between project sections, and so on. 
The product automatically keeps a history of the project, 
producing a database that lets developers see the work 
that has been done on a particular section of the project, 
by a particular developer, or by a variety of other criteria. 


This version features faster performance and graph¬ 
ing capabilities that provide a visual look at statistical in¬ 
formation for better software quality control. Access 
controls provide basic security features for larger work¬ 
groups. 

Track Record vl .5 costs $159 per user. For more in¬ 
formation, contact UnderWare, Inc, 321 Columbus Ave., 
Boston, MA 02116, (800) 343-7308 or (617) 267-9743. 


Apex Data-Aware Grid Goes OLE 

Apex Software Corp. has created an OLE-compatible 
version of its data-aware grid control. The TrueGrid Pro 
OLE control lets Visual Basic programmers create in-cell 
editable and configurable database browse tables with¬ 
out writing code. TrueGrid Pro supports all database for¬ 
mats recognized by VB and data tables of any size. 
Programmers can configure the grid appearance visually 
and interactively at design time. The grid provides a vari¬ 


ety of features, including dividing grid into independent 
panes using a split bar, and individual color and forms 
controls for each database cell. 

The TrueGrid Pro OLE control costs $99.95. For more 
information, contact Apex Software Corporation, 4516 
Henry Street Pittsburgh, PA 15213-3785, 

(412) 681 -4343; fax (412) 681 -4384. 


Telephony Toolkit Supports TAPI 

Stylus Innovation, Inc., has announced that its Visual 
Voice telephony software toolkit will support TAPI (the 
Microsoft/Intel Telephony API). Visual Voice for TAPI is 
an OLE custom control that lets you build applications 
that work with TAPI-compatible fax modems, PBXs, and 
other telephony hardware. Visual Voice includes the 
Voice Workbench, a graphical code generator that lets 
you create and maintain all voice processing objects, in¬ 


cluding voice prompts, menus, and files. The Visual 
Voice for TAPI Early Adapter's Kit, which includes hard¬ 
ware and software, is scheduled to be available in Sep¬ 
tember, 1994. 

Visual Voice costs $495; the Early Adapter's Kit costs 
$795. For more information, contact Stylus Innovation, 
Inc, One Kendall Square, Building 300, Cambridge, MA 
02139,(617) 621-9545; fax (617)621 -7862. 


Spelling Checker Now Multilingual 

Wintertree Software's Sentry Spelling-Checker Engine 
now supports multilingual spell-checking. Previous ver¬ 
sions of the product only handled ASCII alphabetic char¬ 
acters. The new version supports an extended set of 
alphabetic characters based on the 8-bit ANSI character 
set. The company also developed new dictionaries for 
French, German, Italian, and Spanish. 

The Sentry Spelling-Checker Engine is royalty-free, 
comes with source code, and costs $599 ($749 Cana¬ 


dian). The price without source code is $99 ($129 Cana¬ 
dian) for DOS, or $169 ($219 Canadian) for Windows. 
Each package includes American and British-English dic¬ 
tionaries. Dictionaries for other languages cost $199 
($249 Canadian) each. For more information, contact 
Wintertree Software, Inc, 43 RueterSt, Nepean, Ontario, 
Canada K2J 3Z9, (613) 825-6271;fax (613) 825-5521. 
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Readers' Forum 


Ron, 

I hope you get this message. I have a Windows ques¬ 
tion for you. My windows directory contains the file sys¬ 
tem and win with multiple extensions, e.g.: 

system.ini, system.001, system.002 
win.Ini, win.001, win.002 

I know what the system.ini and win.ini files are, but why 
do i have these files with the numbered extensions, .001, 
.002, etc.? Hopefully you or someone with Windows/DOS 
Developer's Journal can help me. Thanks. 

Richard B. Hail 
Marshall Space Flight Center 
205-544-3789 
richard.b.hall@msfc.nasa.gov 

I have discovered this phenomenon myself, and I believe it is 
just installation routines making backups of the standard .ini 
files for your protection. Unfortunately, I am too paranoid to 
ever get rid of these little installation droppings, until many 
months go by and I finally take a deap breath and type "del 
*.0??". -rib 


From: Thor Egil Leirtr 

<notis.telemax.no!Thor.Leirtro@uunet.uu.net> 

Subject: Translation to Chinese 

Hi. I saw your question in W/DDJ of August 1994 
(Oliver Bell asked for information on making applications 
work with the Chinese versions of Windows or OS/2). I 
would just like to mention that we have had very good 
use of the Microsoft Developers Network CDs. The level 1 
CD contains the 'international Handbook for Software De¬ 
sign', a book of 240 pages containing very much informa¬ 
tion. The level 2 CDs come with two versions of Chinese 
Windows 3.1 and SDKs. 

Regards, 

Thor Egil Leirtr 

Thanks for the reference, -rib 


Dear Mr. Burk, 

I am writing to thank you for placing my product, 
Mathematics DLL Toolkit, in your New Products section of 
the September 1994 issue. I wanted to notify you of an 
update. First, my company name has changed to LWE Re¬ 
search (same address). Second, Version 2.0 of all current 


products are available as of October 1, 1994. Third 32-bit 
products are available as of October 1, 1994. Fourth, na¬ 
tive RISC DLLs are coming at the end of the year. The 
only problem with the article is that my phone number 
was not listed. It is 312-734-4549. Again, thank you for 
placing my product in your New Products section. 

Sincerely, 

John A. Jackson, Proprietor 
CompuServe 73353,121 

Thanks for the update! -rib 


Re: SDK Annotation #9 (Aug '94 issue) 

Closing another application's window with a UM_TIMER 
message is cute but dangerous. The enclosed quickie util¬ 
ity, getridof.exe (available on this month's code disk), can 
be used to explore for the dangers. It enables you to de¬ 
stroy any window (or its ultimate parent) with a mouse 
click, using the method in SDK Annotation #9. 

Two dangers are provided for in the utility. First, it is 
possible to terminate Program Manager (or File Manager, 
if that is your shell) without exiting Windows. This might 
leave you without a way to launch programs or even exit 
Windows, so the menu selection 'Help! I smashed Pro¬ 
gram Manager!' (whimsically located on the 'Help' menu) 
simply UinExecOs whatever it finds listed as the shell in 
system.ini. Second, it is possible to destroy the desktop 
window, which belongs to user.exe. My utility merely 
warns with a dialog box that this will crash your entire 
system, but doesn't stop you from doing it if you insist. 

Some applications will behave bizarrely when their 
main window is terminated with a UM_TIMER message. Try 
using GETRIDOF on Windows Solitaire while the cards are 
bouncing after winning a game. The window will disap¬ 
pear but the cards will continue to bounce on the desktop. 

A more sinister danger is that even though the target 
application itself may terminate obediently, some users' 
systems may contain other programs that are also trying 
to hook into the target app in incompatible ways. I use PC 
Tools for Windows, version 1 (I didn't buy the upgrade), 
and I find that its shell replacement ('Desktop') gradually 
goes haywire when apps it has launched fall victim to 
GETRIDOF. One need only explore around from desktop 
to desktop, opening folders and file items and then termi¬ 
nating them with GETRIDOF as one goes, to observe the 
resulting, apparently unpredictable, problems. Sometimes 
Desktop goes into a series of GP Faults. On one occasion 
it corrupted its data files, which I had to restore from the 
last backup. I would guess that Desktop maintains a pri- 
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vate database of all apps that it launches, and that termi¬ 
nating an app with UM_TIMER deprives Desktop of the op¬ 
portunity to update its database so that it later tries to use 
invalid handles or something. 

Even without running anything as pervasive as a sub¬ 
stitute shell, the powerful ScriptTools feature of PC Tools 
seems incompatible with GETRiDOF. If one writes and runs 
a script that pops up a standard Windows message box, 
and then destroys the message box with GETRIDOF, 
GETRIDOF itself suddenly becomes unresponsive and can 
only be terminated by using a second instance of itself. 

The TOOLFiELP function TerminateApp(hVictimTask, 
N0_UAE_B0X) is in my limited experience a safer alternative. 

Larry Kuenning 

Your point is well taken - using UM_TIMERfor this purpose is 
a hack, and should only be used with discretion. Whenever one 
uses an external program to tinker with an application one 
does not have the source to, caution is the word of the day. 


There simply cannot be any completely safe and reliable way to 
terminate a foreign application, unless you are privy to details 
of how the application works (which you may in fact be if 
you've done some reverse engineering). I should revise SDK An¬ 
notation #9 to both note the danger and to point out that, 
more generally, UM_TIMER can be a cheap and dirty way to exe¬ 
cute your code in the context of another application, which can 
be useful for much more tinkering than just application termina¬ 
tion. Even for this more general case, you can also use TOOL- 
HELP to get your code to execute in the context of another pro¬ 
gram, but it is much more complicated (see Matt Pietrek's col¬ 
umn in the August 1994 Microsoft System's Journal for an ex¬ 
ample of how much harder it is to use TOOLHELPfor this), -rib 


Dear Folks, 

I found Charles Mirho's article in the September issue 
(page 31) to be an interesting and useful introduction to 
the subject of echo and reverberation; but I must object to 
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Dr. DeeBee" 

ODBC Tools 

Tools for ODBC development 




Ever wonder why 
your ODBC app is 
not working: Why it’s 
just too slow? If the 
OBDC driver is OK? 

Use Dr. DeeBee 
Tools to find out. 


Dr. DeeBee utilities (Check, Peek, Timer, Test, 

Spy, Replay and Info) reveal the inner workiings 
of ODBC. 

Dr. DeeBee: The smart way to do ODBC. 

SYVWnE, - 

RO. Box 91 Kendall. Cambridge, MA 02142 

617 - 497-1376 
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Write Once, Help Many ! 


HLPDK/PA 



The Cross-Platform Hypertext / Hypermedia 
Help Development Kit 


Write your help source once on your favorite text editor or with 
our sophisticated Windows based help editor, and generate help 
databases for Windows, OS/2, DOS, HTML (UNIX, Mac), 
MS Multimedia Viewer, RTF and text documents with ease. 


Use existing text documents to create complex hypermedia 
databases. Convert Windows help projects to other platforms. 
Add graphics, sound and many more powerful features 
to your help documents. 

Save 50% off list price 1 
Get ail these and much more for only $149! 

Offer ends December 31.1994. List price is S299. 

Call today for your copy of HLPDK/PA 
j, , . and get NewsDB ■ Internet News Hypertext 

Hyper ACl Database generator for free (S40 value). 


P.O.Box 5517. Coralville. IA 52241, USA. 
TeleFax. (.119) .151-841.1. CompuServe 76350.333 
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Our copy protection works. 

Distributors 
welcome 


Anywhere. 

At very reasonable price. 



Intar produces a wide range of 
copy protection devices. Our 
modules are designed to work 
in electrically and mechanically 
demanding environments and 
that is why they are widely used 
In Finnish industry, (e.g. CNC 
servers, PC Supervisor 
programs etc.) 



INTAR Oy, P.0. Box 70, FIN - 00511 Helsinki, FINLAND 
Tel: +358 - 0- 148 4381, Fax: +358 -0-148 4382 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


for Windows 3.x 


0 Shared DLL resources 
supports multiple 
applications and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference. 

0 Control panel utility allows 
dynamic DLL configuration, 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

PO Box 501591, Atlanta, GA 31150-1691 

9 TEL/FAX (404) 663-4888 

Available at ProVantage 800-336-1166 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 & 
8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts ™, our "software 
only" text-to-speech library! 



1. Create fantastic prompts 
and save time with VFEdit ®! 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL™, our Tel I/F 
Dynamic Link Library 

3. Audio Tool Box™ 
converts to and from 


Order Now! 1-800-234-VISI 


Voice Information Systems: 24 N Merion Ave, Bryn Mawr, Pa 19010 
Tel 215-747-5035/ BBS:310-392-6610/ Fax 1-800-234-FX1T 
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Unique Custom Controls 

We've got the controls everyone else 
missed. Whybuyyetanotherpackage 
with a bound text box when you can 
get more? 

Our controls are easy-to-use, solid, 
and royalty-free. Free lifetime updates 
from our BBS. Source code and site 
licenses are available upon request. 

There are too many to mention here, 
so write, call, or fax us for a product 
list. Or, send us $5 for a sample disk. 


Mabry Software 

Post Office Box 31926 
Seattle, WA 98103-6925 

Voice: 206-634-1443 
Fax: 206-632-0272 
CompuServe: 71231,2066 
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Diskette I/O 

Code Libraries 
Device Drivers 
VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 


Sydex 


PO Box 5700 
Eugene, OR 97405 


(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 
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Opt-Tech Sort/Merge 


New -Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 ) 
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BRIDG IT 

Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tei:(602) 991-7272 • Fax:(602) 483-7674 
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from Walnut Creek CDROM 

All ol these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs—quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: Classic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 
w/ GNU & XI1. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/ GNU & XI1 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows $39.95* 

♦shareware requires separate payment to authors if found useful 

Pick up the phone and Call Now! 
1 -800-786-9907 E M US#- 

1-510 674 07X3 • FAX 1-510-674-0821 

email: orders@cdrom.com 

4041 Pike lane, Suite D-691 Concord, CA 94520 
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Development 

Utilities 


World’s largest/best indexed collections of techni¬ 
cal shareware extensively indexed and updated six 
times a year on CD-ROM or diskettes. 30 day 
guarantee. Creditcards. Ship/H $5US, $15Foreign. 

Products_ 

Access 
Assembler 
AutoCAD 
C (Turbo & MS) 

C++ (subset of above) 


FoxPRO/dBASE 
Turbo Pascal 
Paradox 
Visual BASIC 
Sci/Engineering 
Netware 

PC Products Database 
TrueType Fonts 
Windows Utilities 
Any/All of above on 2 


MB/Files 

Price 

36/443 

$59.50 

21/552 

$59.50 

43/1206 

$59.50 

143/1686 

$149.00 

85/820 

$99.50 

105/2978 

$149.00 

83/1981 

$99.00 

53/1080 

$79.50 

38/859 

$59 50 

62/908 

$79.50 

69/427 

$59.50 

249/1748 

$195.00 

185,000 records $25.00 

15/752 

$59.50 

115/998 

$129.50 


CD-ROMs $59.50/$ 195 


EMS Professional Shareware 
4505 Buckhurst Ct.; Olney, MD 20832 
(301) 924-3594, Fax: (301) 963-2708 
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“I wish this was a 
Windows Application” 

You need the power and simplicity of 
ClearWin+™ with Salford’s 32-bit C++ 
compiler for DOS, Windows 3.x and 
Win32 (Windows NT and Chicago). 
Using formats, ClearWin+™ offers an 
innovative approach to the problem of 
producing maintainable Windows code. 
Write a realistic prototype quickly in less 
than 100 lines of code with no previous 
Windows programming experience! 


Salford 

Ao/f/t riu' 



ASK FOR A FREE 
DEMO DISK 

TODAY 

— 


Adelphi House, Adelphi Street, Salford M3 6EN, UK 
Tel: (+44) 0161 834 2454 Fax: (+44) 0161 834 2148 
Fax toll free from USA: 1 800 562 6875 


□ Request Reader Service #239 □ 

Windows/DOS Developer’s Journal — Page 85 

























































his stated intention to use the words 'gain' and 'attenu¬ 
ation' interchangeably (page 33, eighth line). That's like 
using 'up' and 'down' or 'bigger' and 'smaller' inter¬ 
changeably. The fact that attentuation is the reciprocal of 
gain (or its negative in terms of decibels) is no excuse. 

New subject: One reader of my shareware newsletter 
has responded to an article on Wenham Software's BAT- 
COMM batchfile compiler, telling us they don't answer his 
inquiries. I recently sent two letters to them at 5 Burley St., 
Wenjam, MA; they've not answered, but the letters have 
not been returned by the Post Office, either. I assume that 
means the address is still a good one, but they just aren't 
answering their mail. My reader wants to obtain a copy of 
BATCOM. I can't legally send him a copy of mine, because 
their manual states that 'The compiler itself may not be 
distributed.' Any suggestions of how to resolve an im¬ 
passe such as this? 


Sincerely, 

Homer B. Tilton 
8401 Desert Steppes Dr. 

Tucson, AZ 85710 

I have also run into the problem of shareware authors miss¬ 
ing in action, but have no advice for you - anybody out there 
know where this author is? If the author is a member of the 
Association of Shareware Professionals, you can always ask 
their ombudsman to help you track down the missing vendor, 
but they may be no more successful than you are. Of course, 
commercial vendors sometimes also disappear from sight with 
no trace, so I don't want to make it sound like this problem is 
unique to shareware vendors. Caveat emptor! -rib 


Hi Ron, 

As an W/DDJ subscriber, I've got to open by saying 
there are lots of good articles in your magazine which 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 _ 
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WINDOWS DEVELOPERS 

I specialize in finding permanent and 
contract opportunities for Windows™ 
Developers. The market is excellent for 
talented software engineers. Focus on 
recruiting for Colorado and nationwide 
positions. Ail fees paid by the company. 
Give me a call at 1 -800-638-8903. 

— Gary Patton 
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I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

WifidowaiyPOS 

□ developers journal 

Call 913-841-1631 today for 

information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 

Advanced. Serious. 

Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine - Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 
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"If you can’t See it or Measure it... 
you can’t understand it!" 

PinPoint™ 

two new Windows tools for 
one low price: $199 

• Visual Tracer™: See program 
execution flow in real time 

• Visual Profiler™: Measure function 
calling frequencies and execution 
times to 1 ms. Easy-to-use graphical 
display. 

Works AUTOMATICALLY with C/C++ and 
Microsoft™ Visual Basic" 

Avanti Software, Inc. 

(800)329-8889x102 
International +1(415)329-8999 
FAX+1(415)329-8722 

90 day no-quibble guarantee 
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"Quality and Innovative 
Presentation Graphics" 

GigaSoff 

PrdEssenials™ vl.5 

Turn-Key graphic presentation ideal for 
information and quality control systems. 
Windows 3.1 DLL + VBXs. Absolutely the 
best images in the industry. Nine built-in 
dialogs, popup menus, scrolling / random 
subsets and points, maximization, help, 
hot-spots, dual Y axis, and the smoothest 
scrolling via images prepared in memory. 
Export metafiles, bitmaps, and text to 
clipboard, file, and printer. Spawns OLE 
Objects. You must see to appreciate. 


CALL FOR A FREE DEMO ! 
Gigasoft, Inc. 

Phone: (817) 431-8470 
Fax: (817) 431-9860 
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Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 
See for yourself. Download your 
unlimited eval copy. 

Try t complete, free eval copy tonight! 

Our BBS: 206-935-5198 
NET: ftp.halcyon.com /local/wilson 
CompuServe: WINAPA, Sec. 15 
AOL: WindowWare 
Direct: 1-800-762-8383 
Wi/son WindowWare, inc. 
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The 

[TREASURE' 
HUNTERS 

In the world of software, it is y \ 
all too easy to lose a valuable 
treasure: by editing and saving , 
a program, overwriting a vital 
previous version. 

To prevent you from having to 
search in vain for buried treasures, 
ARIS VERSION TRACKING SYSTEM 
for Windows enables you to access 
and use previous program versions. 

AVTS. A gem of a program 
at a diamond price. 


ARIS 

Information-Systems 


Parkstr.2. 85646 Anzing, Germany 
Phone +49-8121-45624, Fax +49-8121-456251 
From the USA, call 
Phone 01149-8121-45624 
, Fax 01149-8121-45625 
Email: CompuServe 100042,1707.. 
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IMWHelp 


Ulindoui/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


YDynaZIP 

I Data Compression Toolkits 


The ROYALTY-FREE DynaZIP family of 
developer's tools let you read, test, 
create, write, and update industry 
standard ZIP files directly from your 
Windows-based products. No more 
"shelling” to DOS, and no more fussing 
with proprietary compression formats. 
Fast, easy to use, and totally reliable! 
Versions for C/C + + , Pascal, VB, 
database, 16 and 32 bit. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: [800] 962-2949 


Inner Media. Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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Spend your time writing your App 
...Not wading through 
DDK documentation!! 

Hardware control for Win32™Apps 
-without the Device Driver Kit 
✓ Port I/O 

✓ Memory I/O 
✓ Interrupts 

Ask us about Alpha™. Power PC™ and 
Chicago versions. 

Blue Water Systems 
(206) 771-3610 
(206) 771-2742 FAX 

73514.132 @compuserve.com 
NT version $595 

Royalty free runtime 

Visa, MC, Approved PO 
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VB = me*: 

Visual Basic Standards 
and Practices 

This amazing book by J. D. Evans, Jr. 
defines a complete set of standards and 
naming conventions for use in managing and 
developing large applications with Visual 
Basic. Innovative, advanced diagramming, 
structuring, and programming practices 
unique to Visual Basic are described in 
detail. Required reading for 

PROFESSIONAL programmers! Book & 
Diskette: $39.90 + S & H $5.95 (UPS). 

ETN CORPORATION 

RR4, BOX 659 

MONTOURSVILLE, PA 17754-9433 
TEL: (717) 435-2202 FAX: (717) 435-2802 
CompuServe: 73641,242 
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WINDOWS DEVELOPERS! 

Text-to-Speech 
Speech Recognition 
Speech Compression 

Software Development Kits 
now available for Windows 3.1 ! 


Set your products apart! 
Speech is the ultimate user-interface! 


& 


LERNOUT & HAUSPIE 


PRODUCTS 


ISPEECHl 

800 W. Cummings Park. Suite 3100, Woburn, MA 01801 
(617) 932-4118 x202 Fax: (617) 932-9209 

(800) 252-4999 x202 
CALL FOR MORE INFORMATION 


S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer's 
MindT 


When the country’s 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT. OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


K Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 


Bar Code Fonts 


If you write enough applications, 
sooner or later you’re going to have 
to print bar codes. And what could 
be easier than calling a font? 

Azalea Software, Inc. specializes in 
quality bar code printing tools. Call 
us today to see how much fun bar 
codes can be. 



software inc. 


Azalea Software, Inc. 
8 oo 48 -ASOFT 
206 952.4030 
azalea@igc.org 
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helped me a lot to complete the scanner utility I built. (It's 
a rather simple one; the user can fill out preprinted forms 
using scanner and printer instead of a typewriter.) It ac¬ 
cepts so far only BMP data files as I took this format for a 
fixed standard under windows. But then a client surprised 
me with BMP files my program refused to work on. One 
of them was a compressed (RLE coded) BMP file, the other 
had a strange bfSize entry in the BITMAPFILEHEADER. The cli¬ 
ent claims his version of paintbrush (Windows 3.11) can 
read both, whereas my version (3.1) cannot read them. 

The information i have about the BMP format is just 
the Petzold bible and the Borland 3.1 documentation. 
Petzold says the bfSize entry is the size in bytes (seems to 
conform with the paintbrush of Windows 3.1), the Borland 
doc says it is the size in DUORDs, in the BMP of my client it 
is the size in U0RDs\ 


The compression scheme does not follow the docu¬ 
mentation of Borland. So: are things underway concerning 
the BMP format? Have things already changed from Win¬ 
dows 3.1 to Windows 3.11? What is the BMP standard 
file? Where is it documented? Is it documented at all? 

Totally puzzled, 

Thomas Gawehns 
Germany 

Well, I know there are old style .bmp files (no color table), 
and Windows 3.x .bmp files (which optionally include a palette), 
and there is the slightly different OS/2 style of bitmap. I am un¬ 
aware of any changes in the fie format for Windows 3.11, and I 
can't imagine what could be going on if the DUORD at byte offset 
two contains half the file size in bytes. Any readers out there 
know what's going on? -rib □ 
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C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, ’C statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-BROWSE Windows graphic-tree viewer. 

• C-DOC Professional f$2991 DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

• 30-DAY Money-back guarantee CALL NOW 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (9051-858-446 

^r^M^^^erromBS]9K|h858j9ie 
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DICE IS LOOKING FOR 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 


DATA PROCESSING 
I NDEPENDENT 
CONSULTANT'S 
E XCHANGE 

ONLINE Number 
515 - 280-3423 

Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
515-280-1144 
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Developer Jobs! 

1 - 800 - 231-5920 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
Specialists in R&D jobs for software engi¬ 
neers, SQA, product managers, etc. 
Nationwide contacts with both large and small 
companies including equity start-ups. Many 
clients develop and publish commercial soft¬ 
ware products. Most develop for Windows, 
NT, Macintosh, OS/2, and Unix based plat¬ 
forms. We also recruit in other leading edge 
technology areas such as PDA, low level and 
real-time, compilers, etc. Managed by gradu¬ 
ate engineers. Send resumd or call to get an 
assessment of your marketability. Never a fee. 

Scientific Placement, Inc. 

Internet: lej@scientific.com 

CompuServe: 71250,3001, AOL: davesmall 
SPI8, Box 19949, Houston, TX 77224 
(713) 496-6100 Fax: (713) 496-0373 
SPI8, Box 71, San Ramon, CA 94583 
(510) 733-6168, Internet: bge@spi.com 
SPI8, Box 4270, Johnson City, TN 37602 
V (615) 854-9444 Fax: (615) 854-9454 
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SOURCE CD ROM s 

LANGUAGE/OS 

LARGEST collection of Source for 
Compilers, Libraries, & Docs for 
computer languages and OS on CD.... 
$34.95 (updated) _ 

LANGUAGE/OS II 

LARGEST collection of Source just 
got bigger! ! A perfect companion to 
Language/OS, with more source for 
compilers, function libraries, and docs 
for standard and research 
languages & OS .... $34.95 

*****Buy both for only $64.95***** 
KNOWLEDGE MEDIA Inc. 

(800) 78 CD ROM (916) 872-7487/FAX (916) 872-3826 
VISA and MASTER CARD accepted 
436-B Nunneley, Paradise, CA 95969 USA 

D Request Reader Service #275 □ 



OSETUP 


Windows Application 
Installation Tool 

"Create installations in minutes..." 

custom display/BMP* prompts *read-me dialog 
decompression • multiple disks-huge files 
version & time/date checking • font installation 
Program Manager group/icon creation 
Registration Database access*INI write/create 

°" hJ $49.95 

Call or write for more info: 

Celtech Software 

16900 Crenshaw Blvd. # 16 Jm 

Torrance, CA 90504 ^T 

310.769.1885 

info@celsoft.com •* 
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"Add support for 36 raster file formats instantly!" ]\ ew 

AccuSoft Image Format Library 

Import - Export - Scanning - Conversion - Compression WsB 
Printing - Display - Image Processing - Special Effects 


Version 


AccuSoft has done it again! You asked for more formats: we 
added 24 new formats. You asked for more speed: we made it 
faster. You wanted advanced color reduction: we added a superb 
new color reduction technology. You wanted thumbnails: we 
added them. You asked for it, you got it-. Version 5! 

Guaranteed to read all raster images in 36 formats! We have 
offered this guarantee for nearly 3 years. This guarantee means 
you and your customers get the highest quality imaging technology 
available. 

Incredibly easy to use interface that simplifies development! A, 
single function call provides support for all 36 formats with 
autodetect. Simply pass the filename to our library'! And if you 
want complete control, we give you that also. 

Al standard image compression techniques are supported 
including Group III, Group IV, JPEG, LZW, Huffman, Packbits, and 
Runlength. You can even create your own file format with Version 
5 using the built-in compression. 

Functions provided include rotate, invert, zoom, pan, scroll, resize, 
crop, sharpen, contrast, brightness, color reduction, gamma control, 
palette control, multi-page display, matrix convolutions, 
thumbnails, and much more. 

Performance is of the utmost importance to our customers and we 
continually push the envelope to achieve faster image loading, 
display, processing and compression. Version 5 is the best 
performer yet! 

We are now the acknowledged leader in imaging toolkits, and 
Version 5 is the next step in the evolution of high performance 
imaging! Call now to order or to get more information about our 
complete line of imaging toolkits. 



New 5.0 features: 

*1? Faster image loading & processing 
5 All new, advanced color reduction 
5 New levels of flexibility 
5 Create your own format 
S New compression algorithms 
5 Display while decompressing 
Status/cancel for all functions 
5 24 new raster formats supported 
Automatic thumbnails of any size 
5 New scanning features 
^ I/O replacement for total control 
Plus many more new features 

New Formats'. 

Now Supporting 

Photo CD 


' ttad only. 


Pro Gold versions 


Fastest imaging toolkit available 
Lightning fast Group IV support 
Fastest JPEG available at any price 
Superb quality scale-to-gray display 
One hundredth of degree rotation 
Cornerstone ItnageAccel supported 
Read any image sub-region 
Multi-page, high speed scanning 


5 C 




Guaranteed to read all raster 
images in existence in the 
supported formats. If you can 
find a valid image we don’t 
read, send it to us and we will 
make it work. 


All Platforms Supported! 


( 800 ) 525-3577 

(508) 898-2770 
(508) 898-9662 FAX 


High Performance Imaging 


Copyright 1994 AccuSoft Corporation. All rights reserved. AccuSoft Corporation 112 Turnpike Rd. RO. Box 1261 Westborough, MA 01581 
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Build VxDs In C/C++ 

No Assembly Required! 

Nu-Megas Soft-ICE/W™ And Virec/s VtoolsD™ 
Now Bundled To Give You More VxD Building 
Power Than Ever Before! 


Develop with VtoolsD 

VtoolsD is a comprehensive toolkit that brings VxD devel¬ 
opment out of the dark ages of assembly language into 
the age of C/C++, and visual programming. 

Now you can enter the realm of Windows system pro¬ 
gramming equipped with tools that leverage your exper¬ 
tise in high level languages. 

VtoolsD was designed 
explicitly for C and C++ 
programmers. You can 
build great VxDs without 
writing one line of assem¬ 
bly language. Build your 
next VxD with VtoolsD 
and save time without 
sacrificing performance. 


VtoolsD Includes: 

■ QuickVxD™ — a visual 
programming code 
generator for fast starts 
on new VxD projects 

■ Optimized C-callable 
VMM/VxD service 
libraries 

■ The only Class Library for VxD programming 

■ Customized ANSI C Run Time Library coded 
specifically for VxDs 

■ Complete library sources 

■ Full support for Microsoft Visual C++ 32-bit 
Edition 

■ Documentation for all interfaces and classes 

Get VtoolsD for Windows 3.1, Only $495! 



Martin 


Debug with Soft-ICE/W 

One of the biggest problems with writing a VxD is debug¬ 
ging it. A VxD runs in 32 bit flat mode at level 0. This 
opens the program up to an entire range of potential bugs 
that you would not encounter in other Windows modes. 
Soft-ICE/W’s powerful break points and its ability to debug 
your entire VxD at source level, make it the ideal tool for 
VxD debugging. 

Not For VxD’s Only 

Soft-ICE/W takes you inside Windows! Debug and 
explore with power and flexibility not found in any 
other Windows Debugger! 
Soft-ICE/W allows you to 
debug at the systems or 
applications level or simply 
learn the innerwvorkings of 
Windows. 

■ Debug drivers and 
interrupt routines 

■ Debug interactions 
between DOS, 

TSRs and Windows 
Applications 

■ Debug Windows and 
WIN32S applications 

■ Debug programs in 
DOS boxes 

■ Display valuable sys¬ 
tem information (from 

the total memory occupied by a Windows application, to 
the complex internal structures of Windows) 

Get Soft-ICE for Windows, Only $386! 


GET BOTH IN THE VxD BUILDER’S BUNDLE NOW AND SAVE! 


v 

Vireo Software 

385 Long Hill Road 
Bolton, MA 01740 



Risk = Null 

30 Day Money Back Guarantee 

C f Nu-Mega 

J TECHNOLOGIES INC 
You're Not Alone. 

P.O. Box 7780 
Nashua, NH 03060-7780 


CALL 1-800-4-NUMEGA ( ) 
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